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I. INTRODUCTION 


A. MICROCODE GENERATOR PROPOSED 

Programming in microcode is not like programming in a structured 
language like Pascal or like machine level assembly language. High 
order language programs aren’t written with concern for computer 
hardware or any of the internal details concerning program execution. 
Programmers concerned with the contents of registers; say, compiler 
writers, must be more familiar with the internal components of the 
computer. They can’t easily generalize their programs to work with 
several different computers like a Fortran programmer, but it can be 
done. Microcode programmers must be even more specific in their 
concern for the hardware. 

The microcode programmer is most likely to be a member of the 
design team for a new processor or specifically involved with computer 
control unit implementation. The ones and Zeros (which make up the 
microword) are direct signals to the hardware components. Designs for 
machine instruction sets and supporting registers, PROMs (Programmable 
ROMs), control lines, etc. involve extensive detail, at a level much closer 
to the machine, which the microprogrammer must know. 

Computer aided design is a relatively new field which sprang into 
being when we needed more complex computers to solve more complex 
problems. Designers could no longer hold all the detail in their heads, 
they needed a computer to help in the design process. For example, 


computer systems generate circuit diagrams in seconds; graphics 


stations display VLSI drawings, zooming in on selected areas and 
modifying them with a few commands from the user. Few areas of 
computer design are left where tedious tasks haven’t been automated. 
One such area is microprogramming. 

A microcode generator could aid the designer in several ways. The 
generator promotes structured design since it hides the details of how 
the microword is produced. The user could select a function such as 
"add the contents of two registers" and the generator would provide 
the microword which accomplishes the task. The function of microcoding 
could be modularized so that the user only needs to know what input is 
required and what output will be given by the’ generator. The 
importance of modularization and information hiding was introduced by 
D. L. Parnas in 1972. [Ref. 1] A microcode generator could also help 
reduce the simple coding errors easily made such as writing a ‘$l’ 
instead of a ‘0’, or putting the ‘1’ or ‘0’ in the wrong bit position. 

A good comparison of the use of a microcode generator would be to 
the use of a calculator. One knows how to add large strings of 
numbers using pencil and paper but the overall task is done faster, 
accurately and without tedious sidetrips by using the calculator. The 
difference between the microcode generator and the calculator is that 
while a parent may worry that with a calculator his sixth grader might 
forget the multiplication tables; the chief designer needn’t worry that 
the use of a microcode generator might spoil his young team members. 
The point is that the programming level required to use a microcode 


generator is already that of expert microprogrammer. The generator 


merely frees the programmer to think higher level thoughts, and thus, 
is truly a needed utility in the area of computer aided design. 

I have implemented a microcode generator for a specific machine; 
the Am29203 Evaluation Board which will be described in the following 
chapters. The generator is written in the high-level language C. C was 
chosen since a well defined standard for the language exists so future 
"porting" of the program to other machines will be easier. The utility 
program is designed to be interactive with the user and operates in real 
time like a language interpreter. The user selects functions from the 
menus displayed and is provided the appropriate microword. Microwords 
are saved in microroutines which can be stored for later use. The C 
program is currently implemented on the NPS VAX/Unix system. Future 
research plans are to modify it for use with microcomputers. 

Chapter two will provide some background information on micro- 
programming and the microcode generator targeted machine, the Am29203 
Evaluation Board. Chapter three will discuss the design approach used 
in this project. Chapter four will address specific implementation 
problems and data structures used. It will also introduce a preliminary 
user’s manual. Chapter five will contain some conclusions and 


recommendations. 
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II, BACKGROUND 


A. MICROPROGRAMMING 

In order to discuss microprogrammed computer architecture, a 
reference point must be established. Computer architecture is the study 
of the systematic method in which the basic components of computers 
are arranged and interconnected. A convenient reference point is the 
high-level abstraction of a general computer system called the von 
Neumann machine. This idealized concept of the essential organization of 
a computer, developed in the mid 1940’s, was the key to he con- 
struction of early computers. The von Neumann machine consists of five 
basic elements; the Control Unit, Arithmetic/Logic Unit (ALU), memory, 
input and output. In today’s computer systems the elements containing 
the Control Unit and the ALU have been combined to form the Central 
Processing Unit (CPU) or the processor. 

The Control Unit implements the designed machine level instruction 
set. The machine level instructions or macroinstructions can _ be 
executed in two ways. Implementation in hardware using combinatorial 
logic was the method used in early computers and by some high speed 
machines today. However, the focus of this thesis is on the modern 
method which implements the control unit using memory or stored logic. 
The contents of the stored logic are called microinstructions. A micro- 
programmed control unit is one in which the more complex macroinstruc- 
tions (op codes) are interpreted (executed one at a time) by sequences 


of primitive microinstructions which are stored in the special memory 


1 


called Control Store. These sequences of primitive microinstructions are 
called microprograms; stored programs that explicitly control the data- 
flow through the physical components of a processor. This method is an 
alternative to performing data-flow control with a network of sequential 
logic circuits. [{Ref. 2: p. 5] 


1. History 


The early computers’ instructions for arithmetic and boolean 
functions were directly implemented with hardware. One could look 
inside the computer and trace the circuits responsible for a particular 
function such as multiplication. These basic logic circuits such as AND, 
OR, etc. were constructed from switching devices aceh as vacuum tubes, 
diodes and transistors. The outputs of the resulting storage elements, 
ie., flip flops and latches, control the execution of arithmetic or logical 
operations by issuing control pulses over the control lines to specific 
gates in the data flow. In a relatively few machine cycles, information 
is guided to flow over many paths and through many functional units in 
the specific order required for the execution of the macroinstruction. 
Hardware implemented control units require many basic components and 
intricate wiring efforts in their design. They have a haphazard 
appearance due to the mass of wires and circuits placed on the circuit 
board in any place they could be fit. Complex instruction sets were 
difficult to implement because the design task alone was a tremendous 
undertaking. It was a lack of modularity in the design process which 
forced the designers to maintain a complete understanding of the entire 


design in their heads. 
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The disadvantages of hardware implementation are that anv 
changes could mean an entire redesign; documentation was scarce; and it 
was difficult to test the implementation since much of it had to be 
working just to test one small portion. The advantages are that it can 
be the fastest running implementation, a small task (simple design) will 
have a simpler solution and the complexity and lengthy design time can 
be justified for high volume applications. In a microprogrammed 
machine each machine-level or macroinstruction is carried out one 
instruction at a time by an interpreter. 

M. V. Wilkes, in 1951, first proposed a microprogrammed control 
unit in a computer. [Ref. 3: pp. 16-18] The microprogrammed method 
was easier to use in the computer design development and engineering 
phases, Wilkes proposed. He and his colleagues sought a means for 
rearranging the circuit design into a systematic order which was easy 
to implement, comprehend and maintain. They were more interested in 
simplifying the design task than in any savings of hardware. It is 
interesting to note that while Wilkes didn’t believe there was any need 
for general purpose computers or the corresponding complex instruction 
set, the microprogrammed control scheme he presented made the concept 
of a general purpose computer feasible. The general purpose computers 
in use today have instruction set sizes on the order of hundreds of 
instructions. The design and implementation of a system of combi- 
natorial logic with such a complex control system would be very expen- 


Sive to manufacture. 


13 


Buffer 


Sequence 
Lines 


Control Lines 





Scales 
ee 
ieee 


Register 


14 


Decoding 


Tree 


From Conditional 
Flip~Flop 


Fe 


Fig. 2.1 Wilkes Control Unit 


Wilkes viewed the Control Store as consisting of two ferrite core 
matrices. [Ref. 4: p. 497] (See fig. 2.1) A portion of the macro- 
instruction called the operation code or op code was used as input to a 
decoding logic tree. The logic component accepted n bits as input and 
provided 2" possible output lines, only one of which was_ selected. 
Thus, a four bit input line could select one of sixteen output lines 
which were the microinstructions. Each output line was configured with 
diodes to select any number of available control lines. The active 
current in the selected output line was passed on by a diode to the 
connected control line in the first matrix. So the configuration of 
diodes on the output line determined which control lines were activated 
for a particular clock cycle and a particular microword. When testing a 
design, these diodes were easier to change than rewiring a new hard- 
ware circuit for a particular function. The 2" possible diode configured 
output lines represented primitive operations (the microinstructions) 
which when selected in sequences formed short subroutines’ which 
carried out the function specified by the op code. The second matrix 
was used for sequence control. Each microinstruction could select the 
next microinstruction to be executed. Wilkes’ implementation also 
included a provision for some conditional testing and sequencing. 
These diode arrays were the first microprogram memory or Control 
Store. 

2. Development 

While macroinstructions penerally effect changes to data in main 

memory, Microinstructions reflect register to register data transitions. 


Cycle time ratios between main memory access and control store access 
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are critical. There must be sufficient time available per 
macroinstruction for the microroutine instructions to be completed. The 
diode control store method posed no speed problems since the speed 
ratio was about twenty internal cycles per memory cycle. [Ref. 4: p.498] 
The trend of smaller cycle ratios developed quickly, due to improve- 
ments in memory technology. By the early 1960’s main memory cycle 
speed had dropped to under one microsecond. [Ref. 4: p. 499] The ratio 
of internal machine cycles to memory cycles became one or two to one. 
It wasn’t possible to decrease the control store access speed _ so 
parallelism was needed in data transfers. Multiple data transfers per 
machine cycle resulted in simultaneous control of internal resources. 
The microwords (microinstructions) were made wider to produce more 
control signals per machine cycle. Parallelism was increased with the 
addition of more control signals per microword. However, the use of 
wider microwords required more space in control storage. 

Emulation, the use of control stored microprograms to interpret 
several different processors’ instruction sets on one host system, (Ref. 
5: 405] was implemented by IBM on the System/360 in the mid 1960’s. 
This new application for microprogramming was very important for 
businesses which did not want to have to reprogram old software but 
did want to use new programming languages and develop new appli- 
cations on newer higher performance machines. 

Fast read/write control store was developed in 1970 using 
bipolar monolithic beetmoleeed [Ref. 4: p. 499) Thus, the control store 
has the same access time as combinatorial-logic gating delays, since they 


are made of the same material. Writable control storage can be very 
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important in computer system research and real-time, embedded 
computer systems (military applications) since updates and/or config- 
uration changes are more easily handled with the flexibility of 
microprograms which can be over-written. 

The simplest implementation of a microprogrammed control unit 
consists of a register or buffer, timing signals and a ROM (Read Only 
Memory). The register contains the macroinstruction which holds the op 
code to be implemented with a microroutine. The op code is used to 
derive the starting address in the ROM, called control store, of the 
appropriate microroutine to be executed. Each microword contains a 
code rdicatinz that either it’s the last microword in the routine or that 
the next sequential microword in control store is to be used next. This 
scheme causes fragmentation or unused portions in control store since 
each starting address is equidistant from the others and thus, all micro- 
routines are alloted the same amount of space even though all routines 
are not the same size. 

A mapping PROM (Programmable ROM) can be used to improve 
the addressing scheme. The fragmentation problem is solved since any 
set of addresses in the control store can be placed in the mapping 
PROM so the microroutines can be any size. With the use of a Writable 
Control Store (WCS) microroutines can be easily changed and new 
starting addresses updated in the mapping RAM (Random Access Mem- 
ory). A MUX (multiplexor) for conditional codes can be added to include 
conditional branching capability. 

Another important improvement has been the Beaton of a buffer 


register at the output of control store; the pipeline register. Its use 


Pe 


allows pipelining, the overlapping of microinstruction execution with 
control store fetches. While the microword in the pipeline register is 
being executed, the next instruction is being fetched from WCS. All 
these improvements over the simple three element control unit provide 
the needed capabilities for an efficient microprogrammed control unit. 
3. Am29203 Evaluation Board Description 

An Am29203 Evaluation Board prototype is used for micropro- 
gramming experimentation in the NPS Computer Science Department. The 
evaluation board is built, using bit slice architecture, from various 
bipolar integrated circuits (IC’s) produced by Advanced Micro Devices of 
Sunnnanle CA. The Am29203 is an implementation of an Arithmetic/Logic 
Unit (ALU). This board is presently used in research at NPS as a 
representative microprogrammable digital system. As the target 
microprogrammable device for the microcode generator, the evaluation 
board is briefly described here, and in more detail in later chapters. 

The board consists of three main IC types and memory for 
Writable Control Store (WCS). [Ref. 6] It uses an Am29203 four bit ALU 
slice. This ALU chip can perform seven arithmetic, nine logical and 
sixteen special functions on two four bit operands. The evaluation 
board cascades four Am29203’s to provide a sixteen bit ALU. The board 
also uses the Am2904 Status and Shift Control Unit, which supports the 
functions of the ALU. The third main IC is the Am2910 Sequencer used 
in the board’s control unit. It is the microprogram controller for the 
sequence of execution of microinstructions stored in the WCS. it 
provides both sequential access and soniciuionel branching to addresses 


in the WCS. 
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The Am29203 ALU Evaluation Board is set up with a monitor 
which can display and load all memories and registers. To run micro- 
programs, load the microwords in hex into WCS; the status registers and 
macroinstruction registers should be loaded with appropriate data if 
conditional testing is to be performed. Enter the command G (for Go). 
After execution the registers and/or memory can be inspected (dis- 
played) for indications of the intended results. The execution of a 
microroutine can be halted or paused and breakpoints can be set. The 
board is manipulated via the monitor much like a debug utility program. 

4. Microword Format 

The microword used to control the evaluation board is 48 bits 
wide. It incorporates the techniques of bit steering; using a bit or 
field of bits to determine the meaning of another field, [Ref. 5: p. 172] 
and vertical programming in some fields. The microword is organized 
into three main fields which control the three main IC’s’ mentioned 
above. A discussion of the function of each bit of the microword 
follows, starting with the most significant bits: [Ref. 6: pp. 3.10-3.12] 

47-45: Controls the selection of the register address fields 

which select the microinstruction pipeline register 
(the output microword from WCS) or the macroin- 
struction register as’ either the sources for the 
ALU operands or the destination of the ALU opera- 


tion result. 


44-32: Control fields for the ALU: 


44; Enables ALU output to ALU registers. 
43: Enables ALU output to the Y bus (the main data 
bus). 


42-40: ALU source operand selection. 


39-36: ALU destination selection. 


a 


35-32: 


31-16: 


31-30: 


29-24: 


23: 


Gas 


Zi 


20: 


19-16: 


15s 


pa 


13-0: 


13-4: 


3-0: 


ALU function selection. 


Control fields for the Am2904, Status & Shift 
Controleenim: 


Controls carry-in. 

Called I5-I0. These six bits control the micro and 
macro status registers. This field is highly depen- 
dent on other fields, and is extremely difficult to 
coordinate when programming. 

Enables micro status register. 


Enables macro status register. 


Command enable to use 19-16 as a command field 
for special functions of the ALU. 


Shift enable to use 19-16 as shift control. 


Used as a field for ALU special functions, for shift 
control, or for status enable. 


Monitor breakpoint bit. 

Not used. 

Control fields for Am2910 Sequencer: 

Branch address; or in conjunction with bits 47-45 
could be used for data constants or to specify ALU 


registers as sources of data or addresses. 


Sequencer instructions. 


Following chapters will go into greater detail when addressing 


the design approach to implementing the functions of the different fields 


in the microword. 
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III. DESIGN APPROACH 


Design may be defined as the process of applying’ various 
techniques and principles for the purpose of defining a device, a 
process, or a system in sufficient detail to permit its physical 
realization. [Ref. 7: p. 128] The field of software engineering has two 
general aspects. One aspect contains the general theories and 
principles proposed and tested over the last fifteen years, as the art of 
producing software became a science, i.e., a more disciplined approach 
was needed to combat the recognized "software crisis" of skyrocketing 
development costs of software beginning in the 1970s. For example, 
Edsger W. Dijkstra wrote, in 1968, a now famous letter called "Go-To 
Considered Harmful.” [Ref. 8] He had discovered that the difficulty in 
understanding programs making heavy use of go-to statements was a 
result of the "conceptual gap’ between the static structure of the 
program in spatial terms and the dynamic structure of the program in 
temporal terms. This is called the Structure Principle. [Ref. 9: p. 137] 
Another accepted concept was mentioned in chapter one; the Information 
Hiding Principle first proposed by D. L. Parnas in 1972. The second 
aspect of software engineering is the large group of methodologies or 
techniques available which are specific design tools and solutions for 
virtually any software engineering problem in existence. Thus, we have 
principles on one hand and practices on the other. In this chapter I 


will explain some software principles and accepted practices I have used 
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in the design approach to the problem of building a microcode 


generator. 


A. USING SOFTWARE ENGINEERING THEORY 

The selection of the program development system and programming 
language to use depends on the main features of the project to be 
designed. The microcode generator utility is interactive, featuring 
menu-driven versus command-driven microinstruction functions, l.e., the 
functions are selected through a series of menus presented on a 
monitor. The program acts very much like an interpreter; a one-pass, 
step-by-step translator. The microcode generator functions’ are 
modularized and separated into function procedures which can be 
offered as possible selections by the user in one menu on one monitor 
screen. The combination of this modularity and the use of menu-driven 
function calls support the theory that structured software programs are 
better in that they are more understandable and easier to implement 
with structured programming languages. The program is relatively large 
and complicated. It has two main modules, the sequencer module 
contains eleven submodules and the ALU module contains fifteen 
submodules. There is a main utilities module which contains fourteen 
modules. The two main modules and a housekeeping module frequently 
call on the procedures in the utilities module, which do most of the bit 
manipulation within each microword. Thus, the main features of the 
microcode generator are its use of interactive communication with the 


user, menu-driven information flow and complexity. 
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Such a large, complicated and interactive program is more easily 
developed on a medium to large computer. Using a microcomputer for 
the program development would involve more work on the programmer’s 
part to manage a small memory, the storage of data arrays and the 
overhead of the interactive feature. The VAX 780 computer running the 
Unix operating system was chosen for its easy-to-use program 
development system, convenience (located on campus), and because 
previous thesis work on this project had been done on the VAX. 

The programming language used to implement the program needed to 
be a modern structured high level language available for use on the 
VAX but portable enough to allow the program to be adapted for fee at 
a microcomputer workstation. I chose the C language for its portability, 
Since a well-defined and accepted standard had been established by its 
authors, Kernighan and Ritchie, [Ref. 10] and for its success as a 
systems programming language. The latter is important since quick, 
efficient code and access to system functions, the characteristics of a 
systems programming language, is needed in an interactive program 
performing in real time. The previous implementation of the microcode 
sequencer portion of the target machine had been written in Berkeley 
Pascal. I chose to rewrite this section in C since the two languages 
employ different parameter passing modes and data couldn’t be passed 
between the different modules. Pascal, a language designed primarily as 
an educational tool for teaching structured languages, was also ruled 
out because of its limited capabilities in input/output processing. One 
of the main differences between Pascal and C is C’s capabilities in 


systems programming. For Pascal to do some of the same sort of data 
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manipulation, it would have to violate the Security Principle. This 
principle states that no program should violate the definition of the 
language, or its own intended structure. [Ref. 9: p. 7] The C language 
contains powerful features that give it considerable flexibility. Like 
other languages in the structured category, C supports strong data 
typing, makes extensive use of pointers, and has a rich set of operators 
for computation and data manipulation. [Ref. 7: p. 277] So the definition 
of the C language contains the needed features that Pascal must violate 
its own definition to effect. 

Modularity, information hiding and portability are a necessary 
influence on the design of this project. In order to ee hioge portability 
to other compilers and machines, some care is needed to provide for 
information hiding, i.e., generality within the modules and passing the 
machine and/or compiler dependent data through the interfaces between 
modules. Thus the modules themselves can be used for any machine or 
compiler and only the interfaces need be changed. The C language has 
a preprocessor feature which allows constants to be defined (using 
#define statements) and placed in a separate module to be “included” 
(using #include statements) as a separate file. Thus, we could have 
separate definition "include" files for different machines and compilers. 
This is a standard feature of the language. 

The above principles are associated with good design and 
programming practices. Using them as guidelines for the selection of 
the basic hardware and software tools for this project ensures quality 


of the end product. 
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B. MAN/MACHINE INTERFACE CONSIDERATIONS 

Man/Machine interface discussions uSually center on_- graphics 
capabilities. However, the design of the microcode generator is not so 
concerned with the way a general user views the screen, but with the 
way an expert user thinks through the problem of microprogramming. 
As stated in an earlier chapter, the user is assumed to be an expert in 
microprogramming and familiar with the specific machine for which this 
program is written to produce microcode. This new utility will improve 
his productivity and provide ease and flexibility in his design work. As 
he uses the program, he should be comfortable with the sequence of 
menus presented so that as he decides what the next step of the 
microprogram should be, the method to take that next step is before him 
on the screen as one of the menu selections. The most common theme 
heard from interactive systems designers is embodied in Hansen’s First 
Principle: Know the User. [Ref. 11] This principle is of primary concern 
in this software implementation project. 

There are more general human characteristics which must be dealt 
with in any interactive design. Humans have a short term memory 
capacity of only about 5-7 objects. Memorization can be minimized by 
using function selection versus command entry methods and using names 
instead of numbers for the choices. The microcode generator program 
Menus do use names except when numbers are the object of the 
selection. ‘'Muscle memory" refers to the idea that users develop the 
feel for frequently used keypresses. This means that the same function 
in different menus should be initiated in the same way; help or return 


to higher level, for example. 
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Another important interface consideration is the input device(s). 
Thus far no other input devices are available for use with the VAX 
development system used in this project. However, an excellent input 
device for selection is the mouse. Its most common criticism is that it 
takes the user’s hands from the keyboard, but this is important only to 
word processing applications where speed typing is advantageous. The 
microcode generator’s user will have his attention focused on the screen 
which is perfect for using a mouse. When the code generator is 
adapted for use on a microcomputer workstation a mouse could be 
implemented as the input device for menu selection. Using a mouse also 
creates muscle memory which improves the user’s productivity. Other 
input devices include joysticks, speech recognizers, tablets, etc. Speech 
synthesis and recognition quality is improving quickly but the mouse 
has the characteristics of simplicity, flexibility and cost effectiveness 


which make it a very popular device for use with interactive programs. 


C. METHODOLOGY USED 

Once software engineering concepts are understood, actual 
implementation of a project is the next step. The explanations of what 
is going to be done, using what guidelines, who is going to do it and 
why it’s important, have all been presented. The next step is how to 
implement the microcode generator. Every company and government 
agency responsible for producing software has some formal or informal 
development methodology, a collection of methods, chosen to complement 


one another, along with rules for applying them. [Ref. 12: p. 14] The 
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methods chosen to design and implement the code generator will be 
discussed in the following sections. 
1, Specification Phase 

The basic requirements of the specification phase of a software 
development project are to describe the intended data flow and data 
structure to be realized in the program, provide a description of the 
program functions, and establish and maintain communication with the 
user. [Ref. 7: p. 95] 

The internal structure of the C source program is modular in 
that each logical microprogramming function, selecting the branch 
address to be used in the sequencer portion of the microword for 
example, is implemented as a separate procedure. (Procedure is a 
generic term for what is called a function in C.) Also the "main” 
procedure does little but initialize, call the modules selectable from the 
master menu and help the user exit the program. 

This modularity is necessary when a top-down design technique 
is used as in this program. Top-down or stepwise refinement begins 
with a high-level representation of software procedure. First, the 
“main” program or driver program is defined; then each procedure 
called by the driver program is written in code and so on. [Ref. 7: p. 
131] With this technique, the program can be written and tested in 
more manageable pieces. This is a far better method of design than 
writing the entire program before trying to run it. The most important 
reason is that the user can be involved to eas early guidance from 


his, the most important, point of view. 
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The external structure is the dynamic flow of the program from 
the user’s point of view. The motivation for writing the microcode 
generator is to make microprogramming easier and less time consuming. 
An example of a microcode generator in use is AMDASM™ which is 
available on Advanced Micro Devices System/29™, [Ref. 13: p. 10] This 
tool is not interactive and is quite complicated although it is quite 
general. The interactive nature of this project’s code generator makes 
the program more "user-friendly." The menus help the user concentrate 
on the problem to be solved rather than how to run the program. 
Thus, the flow of the program is directed by the hierarchy of menus. 

The descriptions of the functions implemented in the program 
must be specified in this phase. Any changes to these specifications in 
a later phase will mean a slow-down in the development of the software, 
since most work must stop while the implementer backtracks to effect 
the changes. A general description of the program’s functions follow. 

a. Sequencer Functions 

Once the user selectS a sequencer code, the sequencer 
module of the microcode generator determines what support data is 
needed. If the selected code requires a branch address and/or 
condition codes, it requests the data using further menus. Then it 
provides informational messages if the sequencer code _ selected is 
dependent on other sequencer codes which must precede or follow it. 
Provisions must be made for "remembering" the user’s selections to 
ensure that subsequent changes CT the sequencer code in the same 


microword remain consistent with other fields of the microword. 
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b. Support Functions for the Sequencer 

Shift and condition code fields implemented as a result of 
selected sequencer code functions are incorporated into the sequencer 
module of the program. Conflicts between shared function fields are to 
be resolved or gracefully handled. That is error messages must be pro- 
vided which don’t "crash" the program or cause undetected erroneous 
results. A requested function may have up to seven possible bit pat- 
terns. C language structures which hold constant data for comparison 
of microword bit pattern options are used to resolve conflicts in shared 
function fields. If none of the possible patterns are compatible in the 
same microword fields then the user is informed and the requested 
function is denied. 

c. ALU Functions 

Once the ALU function code is selected, the ALU module of 
the program determines which type of ALU function it is, either a basic 
function or a special function. Following the same guidelines as pro- 
vided for sequencer functions, it determines what follow-on data is 
needed to microcode the ALU fields of the microword. This is done by 
presenting appropriate menus based on user choices already selected. 
Fach menu may lead to several additional menus, depending on the 
selection made. After the ALU function is selected the user is prompted 
for operand source data, results destination data with choices for shift 
register manipulations on the results, a decision to enable the Y bus, 
and source register selections if any. The same data structures and 


utilities that are applied in the sequencer module are used. 
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d. Support Functions for the ALU 
The microcode for the shift fields, command fields and 
register selection fields associated with selected ALU functions are 
incorporated into the ALU module of the program. The same data struc- 
tures, utilities and constraints concerning conflicts and errors are used 
as in the sequencer module. 
e. Common Functions 
Each menu has a selection available for help and return to 
a higher level. When help is selected, an informational message is 
displayed to clarify the menu presented and a reference to a manual or 
data boar is provided if possible. Selecting return to a higher level 
displays the previous menu. The user can exit the program entirely by 
repeating the return selection. 
f. Housekeeping Functions 
These functions comprise the third major module of the 
program. They provide the capability for the user to build micro- 
routines by adding microwords to a file as he creates them using the 
sequencer and ALU modules. The user may also save, list, scan, modify, 
delete and print microroutines. These latter functions will be available 
from the master menu and some of them will be available from the 
sequencer and ALU modules. 
¢. Design Phase 
The design phase is the process through which requirements, as 
determined in the specification phase, are translated into a 
representation of software. [Ref. 7: p. 129] The Poa in this phase is to 


produce a "model" from which the final product will be built. This step 
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in the development of a software project can be compared to the build- 
ing of a prototype in an engineering project. 

The "models" used to represent the program are _ hierarchical 
module organization charts. In figure 3.1 the hierarchical structure 
between the major modules is shown. Figure 3.2 shows the relationship 
between the menu calling procedures. This model reflects the rela- 
tionships between the menus and shows the program structure from the 
user’s point of view. These two models are adjusted until the internal 
program structure (figure 3.1) supports the external structure (figure 
3.2) which is the user’s point of view of the program. 

3. Implementation Phase 

In very general terms, the implementation or coding phase 
translates a design representation of software into a programming 
language realization. This coding process begins when the programmer 
puts source code on paper and continues until an executable form is 
produced by the computer. Improper interpretation of design models is 
a primary concern in this phase. [Ref. 7: p. 267] The characteristics of 
the programming language used influence the way the programmer 
thinks when implementing the design. Earlier in this chapter I 
discussed the reasons why a modularly structured design should be 
implemented using a structured language. The ease of design-to-code 
translation is an indication of how well the language mirrors the design 
representation. C’s support of structured programming and rich set of 


operators make the design-to-code translation very smooth. 
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ALU Instruction and Output Enable Menu 
ALU RAM A Register Select Menu 

ALU RAM B Register Select Menu 


Fig. 3.2 User’s View of Menu System 
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4. Test and Evaluation Phase 

Testing within the context of software engineering is actually a 
series of four steps that are implemented sequentially. [Ref. 7: p. 295] 
Unit testing is a test of each procedure as it is produced. Integration 
testing addresses the issues associated with the problems of verification 
and assembly of all modules in the program. Validation testing provides 
assurance that the software meets all functional and performance 
requirements. System testing verifies that the program meshes with 
other systems in the user’s environment. 

The procedures of the microcode generator were tested as units 
and integrated with the program as they were coded. Thus, the first 
two steps were executed concurrently. 

E. W. Dijkstra is quoted as saying, "Program testing can be 
used to show the presence of bugs but never their absence." Could 
exhaustive testing (even if possible) prove a program correct? No, 
because you don’t know when all tests are exhausted. In testing the 
code generator, the top-down design, modular structure of the program 
made the task easier since functions were broken into small pieces as 
procedures. Each unit was tested by running it with both expected and 
unexpected data. 

5. Maintenance Phase 

Software maintenance is far more than just fixing errors in a 
program; it consists of all support for the product once it released. 
There may be several versions of the same program which need support. 
The maintenance of existing software can account for over 60 percent of 


all effort expended by a software development company. [Ref. 7: p. 322] 
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Software maintenance may be defined by describing four ac- 
tivities that are undertaken after a program is _ released. Corrective 
maintenance includes diagnosis and correction of any errors which may 
exist after the program is released. Adaptive maintenance is the 
activity that modifies software to properly interface with changing 
system support. Perfective maintenance provides the software package 
with new capabilities, modification of existing functions and general 
enhancements requested by users of the product. Preventive 
maintenance is done to improve future maintainability or reliability. 
This type of maintenance is still relatively rare. [Ref. 7: p. 323] 

Academic research projects don’t have the same requirements for 
maintenance as a new product in the commercial market. The 
maintenance of the program generator will depend on the availability of 
interested students for further research. However, further work is 
needed in this’ project. This thesis is just a small step in the 


development of a fully generalized functional microcode generator. 


D. SUMMARY 

Software engineering is still more of an art than a science, even 
though the application of systematic methodologies began about a decade 
ago when software developers faced the software crises. But, the use 
of a more disciplined, engineering approach to software design has 
helped developers manage more efficiently the large, complex type of 
problem solutions undertaken in the 1980's. 

The microcode generator implementation is a large and complex 


problem for one person. Thus, the "modularizing" of the process, i.e., 
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breaking the project up into the distinct steps of specification, design, 
implementation, test and evaluation, and maintenance helped me _ to 
conceptualize the entire process. In shipboard administration terms, I 
formed a "Plan of Action and Milestones,” a POA&M, and carried it out. 
The next chapter will address specific data structure 
implementations, coding problems and introduce a preliminary user’s 


manual. 
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IV. IMPLEMENTATION 


The planned sequence of implementation was’ discussed in the 
preceding chapter. In this chapter I will address specific decisions 
concerning required data structures and the general composition of the 
source program for the microcode generator. This discussion will 
include the general utilities, the housekeeping utilities and the header 
files. A section on how to run the program is provided as a guide to 
using the microcode generator. The last section of this chapter 


addresses some ALU implementation difficulties. 


A. MENUS 

Interactive programs can be designed to interface with the user in 
two ways; command-driven or menu-driven. The command-driven method 
requires the user to know what commands are available, and the rules 
and syntax necessary to use them. The menu-driven method is more 
"user-friendly" since the user is allowed to pick from a menu of 
available functions; he doesn’t need to memorize a great deal of detail. 
The tradeoffs between the two methods are speed and flexibility in the 
first case and ease of use in the latter case. The main decision point 
when choosing between the methods is at the point where a program 
becomes too complicated for even experienced users to remember all the 
commands needed to effectively use the program. The menu-driven 
method was chosen for this reason, i.e., there are too many possible 


functions available to be remembered in the command-driven method. 
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Current macro-assembler type microprogram generators use batch style 
execution, are thus command-driven programs and are less 
“user-friendly.” 

To estimate the number of commands that would be required in a 
command-driven program is not difficult once the menu-driven version 
exists. Each option on a menu represents a required command or 
subcommand in a command-driven version. The sequencer portion of the 
microcode generator program has 6 menus including a total of 54 options 
to choose. The ALU portion has 20 menus including a total of 214 
options to choose. This totals 268 commands. But, each menu in both 
portions has a "Help" and "Return to Higher Level" option; so these can 
be combined to function under only two commands for all menus. So, we 
have a total of 268 - 2*(20 + 6) + 2 = 218 commands which would be 
required in a command-driven method. The interdependencies of some 
of the microword’s bit fields would further complicate a command-driven 
structure, and these are only the functional microprogramming 
commands. The housekeeping functions lhke saving, listing, scanning 
and printing micro-routines also need commands. Since the average 
number of options per menu is 10, that number should be added to 
account for the housekeeping module. So, the final total of needed 
commands in the command-driven method is at least 228, not counting 
the effect of field dependencies. This is not a reasonable number of 
commands to expect a user to remember in a task like microprogramming. 

The microcode generator program was written using the following 
general concept of program flow: Write a menu to the screen, and then 


trap and test the user’s response using the C language SWITCH 
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construction (the equivalent of the Pascal CASE construct). [Ref. 10: p. 
54-56] The SWITCH case which matches the user selected menu option 
implements the function requested, perhaps displaying further menus 
from which the user selects the proper parameters for the function 
desired. This menu, SWITCH, implement, menu, SWITCH, implement 

continues until the user selects the "Return to System" function. The 


program is roughly half menus and half SWITCH constructs. 


B. DATA STRUCTURES 

1. The Microword 
The forty-eight bit microword for the Am29203 Evaluation Board 
was designed to provide a representation of the functions for a general 
purpose sixteen bit ALU.! The microword, as designed, uses the 
concepts of both horizontal and vertical microprogramming. [Ref. 4: p. 
2901) In a horizontal microword there are many bits for the control 
lines, providing a parallelism in resource handling. This method is 
costly in terms of memory space but is very fast since there is only one 
level of control. A vertical microword has fewer bits and needs further 
decoding to determine which control lines are affected. It is a memory 
space efficient method but usually executes slower than the horizontal 
word because it has several levels which are decoded to determine the 

control lines activated. 
The specific fields in the microword are described in chapter 
two. Several of the Am29203 Evaluation Board functions share bit fields 


trapeareeaaars 


1 The Am29203 Evaluation Board was described in chapters one and 
two. 


39 


in the microword. The register select fields and branch address fields 
share microword bits 36-43.2. The command and shift fields share bits 
28-31. Steering bits 26 and 27 control the enabling of the command and 
shift fields respectively. That is, when bit 26, the command enable field 
is turned on, the command field is enabled in bits 28-31. When bit 27, 
the shift enable field, is on the shift field is enabled in bits 28-31. If 
both the steering bits are on then the field is shared in time as well as 
spatially. The microword won’t make sense unless a compatible bit 
pattern between the shift and command functions can be found. When 
microprogramming by hand, this is the problem the programmer must 
solve in order to optimize his program. The ALU module of the design 
tool implements a procedure which checks for compatible bit patterns 
when potentially conflicting functions are requested. If no compatible 
pattern can be found, the two functions must be coded in two separate 
microwords. Further detail on the specific interrelationships of the 
microword functions can be found in Reference 6. 

The microword, itself, is implemented in a character array data 
structure. It is initialized at the start of the program with X’s which 
represent unassigned or "don’t cares"; if any remain after the process, 
they are assigned a one automatically. The microword is displayed, at 
appropriate points in the user’s session, bit-by-bit and as twelve hexa- 


decimal values, using the utilities Display_word and Display_in_hex. 


ARR mOe REE eee eens Megw anne GS Gea GCEE NOEs ss Hen RaeO eee eE sees aim anaes 


2 Chapter two uses the conventional bit numbering method of right 


to left (47-0). However, in this chapter the microword bits are 
numbered 0-47 from left to right. This conforms to the element numbers 
in the microword array. This method is used since the programs’ 


source code is written this way, and the reader can more easily refer to 
the listings provided in Appendix B. 
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2. The Docu-word 
The Docu-word is a 24 element, integer array data structure 
used to "remember" the function choices requested by the user. This 
“documentation” feature of saving all function choices made by the user 
ig necessary to provide such user-friendly features as warning the user 


when he has requested functions which produce conflicting microcode 


and allowing the user to change previously created microwords. A 
docu-word is created as each microword is built. Each element of the 
array corresponds to a "docu-field" which represents a _ function 


available in the microinstruction. 

Bach myaleetion Board function is represented as an element of 
the docu-word. The entire docu-word is. initialized with zeros, 
indicating that no functions are requested. A docu-field assigned the 
value -1 means the function it represents has been requested by the 
user and the particular choice can be obtained from reading the 
appropriate bit field in the microword. This code is used when there is 
no overlapping or multiple function. A positive integer in a docu-field 
means the corresponding function has been requested and the value of 
the integer indicates a particular sub-function choice. 

3. Docu Utility 

The Docu utility consists of a SWITCH construct using the 
selected function’s docu-field as the case value. Each case assigns the 
proper code, as described above, to the selected docu-field to store the 
user’s function requests. Docu is called from the utility Field set; both 
procedures are in the utilities module. Docu and Field _ set, fereicee 


will be described in the next section) although used as utilities, are also 
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data structures since they establish, in the cases of SWITCH statements, 
the relationships and dependencies between the physical bit fields of 
the microword and ie functional docu_fields. That is, they use the 
function requests and the "documentation" or history of requests for a 
particular microword as input and by following the logic contained in 
the SWITCH cases, produce the properly coded bit pattern for that 
microword. 
4, Field_set Utility 

The Field_set utility consists of a SWITCH statement with a case 
for each physical field. Field_set is called whenever a user selects a 
function Loupe microcoded. The parameters passed to Field_set are 
field_cnt, sub_set and choice. Field_cnt is the argument to Field_set’s 
main SWITCH and indicates the case which refers to the appropriate 
physical field. Sub_set contains the integer code which is used in the 
docu-word to distinguish between classes of functions. Choice holds the 
character pointer indicating the menu option the user selected. In most 
menu functions, the "choice" is eventually converted by a SWITCH to the 
bit pattern used in the microword. 

Each case in Field _set’s SWITCH is a small procedure in itself. 
In general, when a case is selected it first checks the status of the 
corresponding docu-field. As discussed in the previous section, the 
corresponding docu-field value will be zero if it isn’t set and a -l or 
positive integer if it is set. When the appropriate case checks the 
docu-field status, if the value is zero, then the proper coded bit 
pattern is placed in the microword and the docu-field iS set to -l or a 


positive integer. If, however, the docu-field value is not zero, then it 
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has been set previously, and a message is written to the screen for the 
user to confirm that he intends to change the function. If the user 
does not confirm, no changes are made to the microword or docu-word. 
If a change is confirmed then the docu-field and microword are both 
modified to represent the new choice. If the previous function set 
other physical fields then the old docu-field value will indicate which 
other physical fields need to be erased or reset. 

When the requested function shares physical microword fields 
with other functions, the status of the docu-field’s of those other 
functions must be checked also. If their docu-field values are zero 
then no conflict exists. However, if they have been set, then a potential 
conflict exists. If both functions have no alternate bit patterns, then a 
message is written to the screen informing the user that a conflict 
exists; no changes will be made. If one or both functions have alternate 
bit patterns then a compatibility checking algorithm provides a 
compatible bit pattern if one exists, or produces an error message. The 
compatibility algorithm is discussed later in this chapter. 

For a fairly complex example illustrating the use of Docu and 
Field_set consider the selection of a sequencer control code. The user 
selects "sequencer command" from the main menu; then selects, for 
example, choice ‘7’, the "conditional jump via register/pipeline” command. 
This is a sequencer command which requires a value be placed in the 
branch address field of the microword and provides for conditional 
testing as well. The main SWITCH statement in the command select 
procedure of the sequencer module calls the Field_set utility with 


parameters field_cnt = 24 (the Field set SWITCH’s case concerning the 
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sequencer); sub_set = 4 (the sequencer command function divides the 
sequencer codes into four classes); and choice = ‘7’. A sub_set value of 
1 would mean that only the sequencer logical field is coded. (The 
sequencer field is coded for all cases.) A 2 means that both the 
sequencer and branch address fields are coded. A 3 means that 
conditional tests are set. A 4 (the value in this example) means that all 
three functions; the sequencer field, the branch address field and 
conditional test fields are set. 

The first step is to check the history of the function in the 
appropriate docu-word field. If the docu-field’s value is zero, then it is 
set to 4 (passed from the sub_set parameter), this stores the information 
that a class 4 sequencer code is being set. Field_set then places the 
proper bit pattern for a choice ‘7’, "conditional jump via 
register/pipeline”, in the sequencer physical fieid; bits 44-47 are set to 
OL 

However, if the docu-field for the sequencer function is already 
1, 2, 3 or 4, then the sequencer code field has been set by a previous 
request. The user is then prompted to confirm that he desires to 
change the sequencer code. If so, then fields previously set are erased 
(set to ‘XXX...’ these are indicated by the code in the docu-field), the 
new sequencer code is set, and the docu-field is set to 4. 

After the sequencer code is set, the menu for selecting the 
branch address is written to the screen. The user is then prompted to 
enter the desired branch address. The branch address select procedure 
then calls Field_set with field_cnt = 19 (the SWITCH case in Field set 


which manages coding the branch address); sub_set = -l (the branch 
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address function needs no subdivision); and choice = "the pointer to the 
first digit of the branch address entered.” The branch address’ 
corresponding docu-field status is checked; if it is not zero, the user is 
again prompted to confirm the change. If the branch address docu-field 
is zero, or confirmation to change the branch address is received, then 
the address requested is placed (in binary) in the microword. 

The branch address case (number 19) of Field_set also checks 
the status of the docu-field function for register A and B selection. 
This is done because the two functions; selecting the branch address 
and selecting the A and B registers, share the bits from 36 to 43. The 
compatibility algorithm is used to find a compatible bit pattern if 
possible. 

After the branch address is selected the menu for selecting the 
desired conditional test is written to the screen. The user’s options are 
to select a forced pass, forced fail or to go to another menu to select 
the exact test desired. Field_set is called with field_cnt = 25 for the 
conditional testing case of Field_set’s SWITCH; sub_set = 1, 2, 3 or 4; 
choice = "pointer to the choice for the particular test desired.” The 
sub_set code is assigned according to which fields need to be set for 
the conditional tests function. All the different conditional tests are set 
using four different groups of physical fields. The value 1 means that 
the Command Enable field (bit 26) is set; 2 means that the Command 
Enable field and the Command field (bits 28-31) are set; 3 and 4 mean 
that the fields at bit positions 26,28,18,20 are all set. 

First the conditional tests function docu-field is checked; if it is 


not zero then the appropriate physical fields are erased (according to 
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the paragraph above) depending on the value in the present docu-field. 
The docu-field is reset with the code corresponding to the class of 
conditional test newly requested, and the microword is. set. The 
resulting microword for the "conditional jump via register/pipeline" with 
requested branch address and conditional test is displayed, and the 
main menu is again written to the screen. The following is an edited 
version of the sequence of events as seen on the monitor screen when 
the above example is run using the microcode generator. Appendix A is 


an unedited record of a sample session using the code generator. 


MASTER AM2910 SEQUENCER MENU 


What do you want to do next? 
Enter a Q to select SEQUENCER COMMAND 
H for7"HELP with thYs™provuramn 
R to RETURN to system 


AM2910 SEQUENCER COMMAND MENU 
Which AM2910 Sequencer Command do you wish to Chose? 
JUMP: Ze Oe Z 


0 
1 CONDITIONAL JUMP SUBROUTINE - CJS 
2 JUMP MAP — IMAP 


Enter a 


7 CONDITIONAL JUMP VIA REGISTER OR PIPED 


THREE WAY BRANCH - TWB 
HELP with this program 
RETURN to higher level 


Om 


Docu-word: 
00000 00 0 0°00 0.0 07070) 0-0. 0030 iar 


Microword: 
XXXXXXXXXXXXXXXX KXXXXXKKXKXKXXXXKX XXXXXXXXXXX X ON 
fiitt fe fetet {fi7 
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AM2910 SEQUENCER BRANCH ADDRESS MENU 


You have chosen a command which requires a value in the 
register/counter 


ENTER YOUR BRANCH ADDRESS FIELD 
Ht orenbnr with) tas program 
R to RETURN to a higher level 
222 
This is the address being used. 222 


Docu-word: 
Ooo 0 Omi OC O0NOMONO 0 0 0 0 -1 0 0400 4 


Microword: 
ROR OR RK XN KRNKX RR KM. XXXKXKXXXNXNXKXKXXXKX YX TOCOTO00TO001 11 
ia ais ip fat £ eZzZi 


AM2910 SEQUENCER CONDITION SELECT MENU 


You have chosen an AM2910 Sequencer Command which requires a 
conditional test 


What do you want to do next? 
hor FORCED NEASs ceunconditiona l 


for NWORCED FAIL 


Type a P 
F 
Lato Hol ene “condition 
H 
R 


for HELP with this program 
to RETURN to higher level 


Docu-word: 
(peo @On OmOwO Os 2700 0 OOOO eD 0 0 —180. 0 01.0.4 
Microword: 


XXXXXXXXXXXXXXXX XXKXXXXXXXKOX1000 xXxX10001000100111 
fe tastasty ffd8 e227 


ee UTILITIES 

The Utilities module contains many support procedures. The pro- 
cedures binary field, dual field, octal field and hex field convert a 
selected function to the needed bit pattern in respective binary, dual, 


octal and hex sized fields. This is done using a SWITCH statement as a 
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lookup table. For example, the user selects choice ‘8’ from a menu 
which is to be set in a four bit field; the procedure hex_field is called. 
Hex field is passed the starting bit and calls the procedures bit_set and 
bit_clear to set the bit pattern 1000. 

The housekeeping utilities will manage such functions as list, save 
routines, scan, modify and print microroutines. These utilities can be 


called from both the ALU and Sequencer modules. 


D. HEADER FILES 

The use of header files in C language programs increases flexibility 
and organization in the management of program segments. The 
microcode generator program uses two header files to centralize the 
definition of constants and _ externals. Declare.h contains all the 
constants defined using the #define preprocessor feature. Extern.h 
contains all the variables and pointers externally defined. The Declare.h 
file is "#included” with each module. The Extern.h file is included with 


all but the main module. 


E. RUNNING THE CODE GENERATOR 

As stated before, this tool is intended for the experienced micro- 
programmer. The microprogramming techniques and structures for the 
Am29203 Evaluation Board are contained in Reference 6, the Am29203 
Evaluation Board User’s Guide, and Reference 14, AMD’s Data Book. The 
program’s help messages, where implemented, are derived from these two 


references. 
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1. Main Menu 

From the user’s point of view, this program is very easy to use. 
After executing the program, the sequencer module, the ALU module, or 
housekeeping functions like scan or print microroutines can be selected. 
Also, the Help and "Return to System/Higher Level” options are available 
as in nearly every menu in the program. Selecting Help in each menu 
will cause an informational message to be written to the screen, then the 
same menu is presented again. The "Return" function causes the user 
to go back to the previous menu. 

2. Sequencer 

In the sequencer portion of the program, the Sequencer 
Command Menu (fig. 4.1) is presented. This menu displays the 
Sequencer codes used by the Am2910 Sequencer chips on the Evaluation 
Board. As discussed above, the sequencer codes are grouped in four 
classes. The JZ, JMAP, RPCT and CONT codes do not use branches or. 
conditional testing, so only the sequencer code bits are set in the 
microword. The LDCT command requires an entry in the branch 
address field so the Branch Address Menu is then displayed and the 
user enters the desired values for the address. The maximum address 
that can be coded is 3FF hex. If a higher value is entered the user 
will see an error message and the menu is presented again. The CJV, 
Conditional Return from Subroutine, and LOOP commands require that 
conditional tests be set up. A menu called the Condition Select Menu is 
displayed and prompts the user through several levels of menus until 
the desired conditional test is set. The CJS, CJP, PUSH, JSRP, Con- 


ditional Jump Via Register or Pipeline, Conditional Jump Pipeline and 
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POP, and the TWB commands all require both branch addresses and con- 
ditional tests. The two sets of menus are displayed and the user is 


prompted for all selections as before. 


AM2910 SEQUENCER COMMAND MENU 


Which AM2910 Sequencer Command do you wish to chose? 


JUMP ZERO = 2 

CONDITIONAL JUMP SUBROUTINE - CJS 

JUMP MAP - JMAP 

CONDITIONAL JUMP PIPED ING eee 
PUSH/CONDITIONAL LOAD REGISTER/PIPELINE - PUSH 
COND. JUMP SUB. VIA REG OR PIPELINE ~— Jone 
CONDITIONAL JUMP VECTOR - CJV 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT EQUAL 0 — Rica 
REPEAT PIPELINE, COUNTER NOT EQUAL 0 — ReEe@ 
CONDITIONAL RETURN FROM SUBROUTINE 
CONDITIONAL JUMP PIPELINE AND POP 

LOAD COUNTER AND CONTINUE - LDCT 

TEST FOR END OF LOOP —- LOOP 

CONTINUE - CONT 

THREE WAY BRANCH - TWB 

HELP with this program 

RETURN to higher level 


Enter a 


SPruUuyAMVADSFPOoOodrnonaurlwondr oo 


Fig. 4.1 Sequencer Command Menu 


3. ALU 
The ALU module of the microcode generator, although not fully 
implemented, will be used in the same fashion as the sequencer portion. 
The user selects ALU Basic Functions (fig. 4.2) or ALU Special Functions 
(fig. 4.3) from the main menu. The user is then prompted through 


several different levels of menus. He provides input such as_ the 
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ALU BASIC FUNCTION MENU 


Enter the value corresponding to the function you wish to 


perform: 


DPuUuoymmoawmwrowrtonwhwnro 


+ + 


al 


BINA yHM yyy DAN gay yy 


Hote oat Th oth Ra 


tor 


High 

Seon —. | teCarry In 
Roe S = 1 + Carry In 
S + "Carry in 

Carry In 


NOimes ) tuCarry In 


Carry In 

(NOT Ro) + Carry in 
Low 

(NOT R) AND S 
BXCLUSIVE OR S 
EXCLUSIVE VOR =s 
AND §S 

NOR §S 

NAND S 

OR §S 

HELP with this program 


YOMDaad wy 


to RETURN to higher level 


Fig 4.2 ALU Basic Function Menu 
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ALU SPECIAL FUNCTION MENU 


Enter the value corresponding to the function you wish to 


perform: 


DAMmABNMoOaADGDPrPNOAOANN AI HWH ZrO 


Unsigned multiply 

BCD to Binary Conversion 

Multiprecision BCD to Binary Conversion 

Two’s Complement Multiply 

Decrement by 1 or 2Z 

Increment by 1 or 2 

Sign/Magnitude to Two’s Complement Conversion 
Two’s Complement Multiply 

BCD Divide by 2 

Single Length Normalize 

Binary to BCD Conversion 

Multiprecision Binary to BCD Conversion 
Double Length Normalize; First Division 

BCD Add 

Two’s Complement Divide 

BCD Subtract F = R= Ss — 91] + eCanee foe scr 
Two’s Complement Divide Correction and Remainder 
BCD Subtract F = § — R — 1] + anny in BCL 
for HELP with this menu 

to RETURN to higher level 


Fig. 4.3 ALU Special Function Menu 
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sources for ALU operations, the destinations for the ALU results, and 


the selection of registers for the ALU. 


FPF, ALU IMPLEMENTATION DIFFICULTIES 

The ALU module presents some difficult implementation problems 
Since it involves more potential conflicts in the microword bit fields than 
does the sequencer module. The ALU functions which involve shifting 
and carry-in bits pose particular problems since they share bits with 
the conditional testing fields and the command field. Another hot spot 
in the microword is the sharing of the branch address fields and the 
register A and register B fields. 

Compatibility is possible, in some cases, between functions which 
share fields since many of the shifting functions are satisfied with 
several alternate bit patterns (some have up to seven possible patterns). 
However, the program must be "smart" enough to determine when the 
conflicts occur and warn the user. This problem is the most difficult to 
solve in the implementation of the microcode generator. To optimize 
microprograms the programmer has to take every opportunity to code as 
many functions in each microword as possible. If he codes only one 
function per microword there would not be enough room in Control Store 
for all his routines. This task is the most complex and time consuming 
part of microprogramming. So, although the ALU implementation is not 
complete, the solution, in the form of a sample algorithm, is provided for 
the problem of automating the process of optimizing microroutines 
(Appendix C). This algorithm searches through C language STRUCTURES » 


[Ref. 10: p. 119-141] that are set-up to store all the possible bit 
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patterns. It compares the requested function’s bit pattern against the 
-‘STRUCTURE, and then chooses a compatible pattern. Appendix C 
contains the source code of the test program which demonstrates this. 
This algorithm needs to be incorporated into Field_set’s cases which 
incorporate the ALU functions. When there is a conflict, Field_set needs 
to read the microword’s "history" by checking the docu-word and then 
make the compatibility check. If a compatible pattern is found, the 
microword is set, the docu-word is coded to reflect the new function 
added to the word, plus an indication is needed of the possible conflict. 
This is necessary in case the user wants to further modify the 


microword. 


G SUMMARY 

The microcode generator’s program modules and function imple- 
mentations have been described detailing the data structures used and 
the support utilities and files provided. To show how easy the program 
is to use a guide to running the program was provided. The next 
chapter will discuss some conclusions and recommendations derived from 


this project. 


V. CONCLUSIONS AND RECOMMENDATIONS 


A. CONCLUSIONS 

The microcode generator is a needed tool for the microprogrammer 
and/or computer designer. The coding of microwords at the level of the 
machine’s hardware involves’ detailed manipulation of the -= micro- 
programmed control unit’s control lines, registers and functional units. 
The microword fields’ complexity is directly correlated to the number of 
parallel functions that the microword can invoke. As detailed in chapter 
four, there are several shared bit fields in the microword used in the 
microcode generator. The program’s ability to manage function conflicts 
in a "user-friendly" manner relieves the user of the "overhead" of 
tracking the potential conflicts as he designs his routines. The solution 
of this function conflict problem is demonstrated in the sample program 
provided in Appendix C. This compatibility algorithm compares the bit 
pattern of the requested function to a C STRUCTURE holding the 
possible bit patterns of a conflicting, previously selected function. If it 
exists, a compatible bit pattern is found and placed in the proper 
position in the microword. The microcode generator also prevents the 
user from making simple mistakes such as writing a ‘1’ instead of a ‘0’. 
The program "writes" the proper digit once the user chooses the 
function desired. 

The choice of C for the programming language in which to write the 
code generator was perfect for the application. The VAX 780/Unix 


system was predetermined in that it was convenient, accessible and the 
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most powerful system in the department. The C language is an integral 
part of that system. C is difficult to learn because it is intended as a 
production language, not an educational tool. It’s error messages are 
not very specific (eg. BUS ERROR - CORE DUMPED). It is, being a 
systems language, very flexible. There are few constructs to learn 
since everything is done with functions. The standard C function 
library provides all I/O functions since there are none in the language 
itself. The housekeeping functions which require using system calls to 
open/close files should be easier to implement in C. The Unix operating 
system is mostly written in C, so the two environments, C and Unix, are 
highly compatible. 

The microcode generator design is approximately 75 percent opera- 
tional. The Sequencer portion, most utilities and an elementary version 
of the ALU is completed. Initial testing on the Sequencer is complete. 
The program needs to be used in a design environment to find further 
bugs in either concept or implementation. Algorithms have been tested 
successfully which solve the shared field problems in the ALU. The 
function compatibility solution test program is shown in Appendix C. 

I am satisfied that the decision to use the menu-driven method was 
the best way to implement the code generator. As discussed in the 
implementation chapter, the equivalent number of commands needed 
would be too great to use the command-driven method. The menus do 
become very familiar after prolonged use of the program. The slight 


impatience felt is a small price for the program’s simplicity of execution. 
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B. WHAT’S NEXT 

The obvious next step is to finish the implementation of the ALU 
and fill in the ALU portions of the Docu and Field_set utilities. The 
housekeeping functions also need implementation. As discussed pre- 
viously, the compatibility test program will solve the function conflict 
problem. The housekeeping utilities can be completed by writing the 
routines to open files, and then using system calls to save and print 
the routines with user defined names. 

A next step could be to adapt the program to run ona workstation 
used for computer design. Some research is needed to select an appro- 
priate workstation. Some attributes should be: that it runs Unix 
(initially) and that it is readily accessible to students. A move to 
another Unix system would facilitate benchmarking between the VAX and 
the new system. Adapting the code generator to systems with different 
input devices is essential to studying the man/machine interface aspects 
of this project. As mentioned above, one drawback to the menu-driven 
method of interaction is that the experienced user of the program can 
become impatient as familiarity with the menus increases. The use of a 
mouse, for example, as an alternative input device might improve this 
situation. The mouse also presents the possibility of using more 
creative graphics to enhance the use of menus. For example, sensitive 
selection areas could be provided on the screen for the execution of 
frequently selected functions such as "display the microword"”, “erase a 
Bering of bits in the microword," etc. Individuals have different ideas 
of what the ideal method of communication with computers is; designers 


have to try to deal with all, or at least most computer users. 
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The ultimate goal in the level of complexity for this microcode 
generator is to be independent of the target machine. This project was 
targeted for a specific machine and so has not yet reached the ultimate 
goal. After this implementation is completed the next step is to write 
the program to handle some area of generalization. The user should 
enter certain constants concerning his machine either at the beginning 
or during each coding session. In the context of the C language, 
header files for many specific machines could be developed. The user 
obtains only the header files he needs. A configuration program may 
need to be developed so that the basic program could be configured by 
the user at one initial session. There are an infinite number of 
approaches to take in the continued development and maintenance of the 
code generator. In any case, the non-specific microcode generator 
would be an invaluable tool for a designer working with the development 


of microprogrammed instruction sets. 


C. SUMMARY 


The general topic of microprogramming was discussed in terms of 


the microprogrammed control unit. Software Engineering theory and 
practice was outlined in chapter three. The design approach used in 
this project was developed using these principles. Chapter four 


discussed significant points as addressed in the implementation of the C 
language program. An important point is that vertical microprogramming 
techniques, the sharing of function fields in the microword, give rise to 
potential conflicts between the bit patterns required for the conflicting 


functions. This is one of many tedious tasks for the microprogrammer. 
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This thesis has addressed the problem of automating the process of 
functional microprogramming and provided some solutions to. the 


approach and implementation of a microcode generator. 
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APPENDIX A 


The following is a record of a terminal session running the Sequencer 
module. 


% test3 
MASTER AM2910 SEQUENCER MENU 


XXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXX KNXXXXXXXXXXXXXXKX 
{iis Piatt on tt 


The X s indicate bits which are not yet defined. 
What do you want to do next? 
Enter a O to select SEQUENCER COMMAND 


H “for eieiLP with this program 
R to RETURN to system 
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AM2910 SEQUENCER COMMAND MENU 


Which AM2910 Sequencer Command do you wish to Chose? 


Enter a 


YPUAMAOGOAWPOAMANNAUAWNEFHr O&O 


JUMP 7 Z ERG 

CONDITIONAL JUMP SUBROUTINE - CJS 

JUMP MAP - JMAP 

CONDITIONAL JUMP PIPELINE ec or. 
PUSH/CONDITIONAL LOAD REGISTER/PIPELINE — PGer 
CONDITIONAL JUMP SUB. VIA REG OR PIPELINE —=3 ae 
CONDITIONAL JUMP VECTOR wea 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOE HOUALL OU —  RnCE 
REPEAT PIPELINE, COUNTER NOT EQUAL OS— Shree 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP PIPELINE AND POP 

LOAD COUNTER AND CONTINUE - LDCT 

TEST FOR END OF “LOOP —sLOCE 

CONTINUES — secon 

THREE WAY BRANCH —- TWB 

HELP with this program 

RETURN to higher level 
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MASTER AM2910 SEQUENCER MENU 


XXXXXXXXXXXXXXXK XKXKXXKKXKXXXXXXK XXXXXKXKKKXXOOOO 
fer t fof fof fFfO 


The X s indicate bits which are not yet defined. 


What do you want to do next? 


Enter a OO to select SEQUENCER COMMAND 
H for HELP with this program 
R to RETURN to system 


oo 


AM2910 SEQUENCER COMMAND MENU 


Which AM2910 Sequencer Command do vou wish to Chose? 


Enter a 


4 


AmImovovavsDWrowdrnaoaarhrwnro 


JUMP ZEROS Sez 

CONDITIONAL UMP SUBROUTINE Swe. 

JUMP MAP - JMAP 

CONDITIONAL JUMP PIPELINE» 3c P 
PUSH/CONDITIONAL LOAD REGISTER/PIPELINE — Pi 
CONDITIONAL JUMP SUB. VIA REG OR PIPELINE - JSRP 
CONDITIONAL JUMP VECTOR - CJV 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT EQUAL 0 — “RECT 
REPEAT PIPELINE, COUNTER NOT EQUAL O — RPGU 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP Eire Lunt eANp =F Or 

LOAD COUNTER AND CONTINUE - LDCT 

TEST FORVEND (ORF SLOGPr = ShOOr 

CONTINUE was Oa 

THREE WAY BRANCH — TWB 

HELP with this program 

RETURN to higher level 


The sequencer code is already set. 
Do you want to change it? 


y 
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AMZ910 SEQUENCER BRANCH ADDRESS MENU 


You have chosen a command which requires a value in the 
register/counter 


What do you want to do next? 


ENTER YOUR BRANCH ADDRESS FIELD 
Meet opener wath this program 
R to RETURN to a higher level 
ie. 3 
This is the address being used.123 
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AM2Z2910 SEQUENCER CONDITION SELECT MENU 


You have chosen an AM2910 Sequencer Command which requires a 
conditional test 


What do you want to do next? 
for FORCED PASS —- unconditional 


for FORCED FAIL 


Type a P 
F 
T to TEST thevecondirtrena 
H 
R 


for HELP with this program 
to RETURN to higher level 
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REMINDER INFORMATION 
meme nave chosen a PUSH/CONDITIONAL LOAD REGISTER/COUNTER - 
PUSH 
as the AM2910 Sequencer Command 
This command MUST precede the following commands: 
iC Paton teetOOr, COUNTER NOT EQUAL. O 
CJIPP CONDITIONAL JUMP PIPELINE AND POP 


LOOR wees terOR END@Or LOOP 
TWB THREE WAY BRANCH 


Press enter to continue 
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MASTER AM2910 SEQUENCER MENU 


XXXXXXXXXXXXXXXX XXXXXXXXXXOX1LO00 XxX01001000110100 
f fen Trac d234 


The X s indicate bits which are not yet defined. 
What do you want to do next? 
Enter a Q to select SEQUENCER COMMAND 


H for HELP with this program 
R to RETURN to systen 
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AM2Z2910 SEQUENCER COMMAND MENU 
Which AM2910 Sequencer Command do you wish to Chose? 


UME ZO — — JZ, 

COND TE PONALeIUME SUBROUTINE — CJS 

SHON e Tbe = Ue 

COND PLEO st UME err hLINE — «CJ P 

PUSH, COND IT ULONATP LOAD REGISTER/PIPELINE - PUSH 
CONDI PON AN Lee oMiaeolinom vl AThREG OR PIPELINE — JSRP 
CONDITIONAL JUMP” VECTOR — CJV 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT EQUAL O - RECT 
RoebAt PIPELINE, COUNTER NOF EQUAL O -— RPCT 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP, PEPELINE AND POP 

LOAD COUNTER AND CONTINUE - LDCT 

Toler OnR EN Or —LOOP — LOOP 

CONTINUE - CONT 

THREE WAY BRANCH —- TWB 

HELP with this program 

RETURN to higher level 


Enter a 


YPUAMVADGPOWMONOAIHRWNHEH SO 


9 
The sequencer code is already set. 
Do you want to change it? 


MA 
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REMINDER INFORMATION 


You have chosen one of the following AM2910 Sequencer 
Commands: 


JHE JUMP HEGISTER OCR SPIER iN 
RPCT REPEAT PIPELINE, COUNTER NOT EQUAL 0 


These commands MUST be preceded by a 
LDCT - LOAD COUNTER AND CONTINUE 


Press enter to continue 


10 


MASTER AM2910 SEQUENCER MENU 


XXXXXXXXXXXXXXXX KXXXXXXXXXXXXXXX KXXXXKXKXXXXXXX1OO! 
ffrff 2 ee fitg 


The X s indicate bits which are not yet defined. 
What do you want to do next? 
Enter a Q to select SEQUENCER COMMAND 


H tor HELP with this program 
R to RETURN to system 


i) 


AM2910 SEQUENCER COMMAND MENU 
Which AM2910 Sequencer Command do you wish to Chose? 


JUMP Ze aOe 

CONDITIONAT IUMP SUBROUT Vb eeu: 

JUMP MAP - JMAP 

CONDITIONAL JUMP PIPELINE —3Cir 
PUSH/CONDITIONAL LOAD REGISTER/PIPELINE - PUSH 
CONDITIONAL JUMP SUB. VIA REG OR PIPELINE — ie 
CONDITIONAL JUMP VECTOR - CJV 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT BQUAL 0 — =~ RECT 
REPEAT PIPELINE, COUNTER NOT BQUAL 0 — ReEGw 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP PIPELINE AND POP 

LOAD COUNTER AND CONTINUE - LDCT 

TEST FOR END 2OF. LOOP =] Teer 

CONTINUES {scone 

THREE WAY BRANCH - TWB 

HELP with this program 

RETURN to higher level 


Enter a 


OQHmAMmMIaADP OWMDONNOUHWNHeH OC 


e 
The sequencer code is already set. 
Do you want to change it? 


7. 


te 


AM2910 SEQUENCER BRANCH ADDRESS MENU 


You have chosen a command which requires a value in the 
register/counter 


What do you want to do next? 


ENTER YOUR BRANCH ADDRESS FIELD 
Heetor HEEP with this program 
R to RETURN to a higher level 
Z23 
This is the address being used. 223 


aS 


REMINDER INFORMATION 


You have chosen a LOAD COUNTER AND CONTINUE -LDCT- as the 
AM2910 Sequencer Command 


This command MUST precede the following: 


rer CONDITIONAL JUMP REGISTER OR PIPELINE 
RPCT REPEAT PIPELINE, COUNTER NOT EQUAL 0O 


Press enter to continue 
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MASTER AM2910 SEQUENCER MENU 


XXXXXXXXXXXXXXXX XXXXXXXXKKXKXXKXKXXKX XXLOOOLOOOLLIL1IOO 
ff ££ Pekar ee3c 


The X s indicate bits which are not yet defined. 
What do you want to do next? 
Enter a O to select SEQUENCER COMMAND 


H for HELP with this program 
R to RETURN to system 
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AM2Z2910 SEQUENCER COMMAND MENU 


Which AM2910 Sequencer Command do you wish to Chose? 


Enter a 


a 


YU AIMUIUAwWDerPoOWMONInUHPWNHr OC 


JUME ZERGa= J7 

CONDITIONAL JUMP SUBROUTINE —- CJS 

JUMP MAP = MAe 

CONDITIONAL JUMP PIPELINE ecJe 
PUSH/CONDITIONAL LOAD REGISTER/PIPELINE - PUSH 
CONDITIONAL JUMP SUB. VIA REG OR PIPELINE —@iea 
CONDITIONAL JUMP VECTOR - CJYV 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT EQUAL O - RFCT 
REPEAT PIPELINE, COUNTER NOT EQUAL 0 — HEGs 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP PIPELINE AND POP 

LOAD COUNTER AND CONTINUE - LDCT 

TEST FOR VEND Oly LOOrr] -LeGr 

CONTINUE = Cong 

THREE WAY BRANCH — TWB 

HELP with thas program 

RETURN to higher level 


The sequencer code is already set. 
Do you want to change it? 


y 
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AM2910 SEQUENCER CONDITION SELECT MENU 


You have chosen an AM2910 Sequencer Command which requires a 
conditional test 


What do you want to do next? 


Type a 


P 
F 
i 
H 
R 


PORrmuoOnCEDMeAsss— Unconditional 
for FORCED FAIL 

ton thst the condition 

for HELP with this program 

to RETURN to higher level 


oe 


MASTER AM2910 SEQUENCER MENU 


KXXXXXXXXXXXXXKKX  XXXXXXXXXXLXXXXX  XXXXXXXXKXXXX1O10 
fiir rrr fffa 


The X s indicate bits which are not yet defined. 
What do you want to do next? 
Enter a Q to select SEQUENCER COMMAND 


H for HELP with this program 
R to RETURN to system 
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AM2910 SEQUENCER COMMAND MENU 
Which AM2910 Sequencer Command do you wish to Chose? 


TOME ZERO=— JZ 

CONDI LLOuAL JUMP suBROUTINE ~ CJS 

JUMP MAP - JMAP 

CONDITEONAL JUMP PIPELINE - CJP 
PUSH/COND | |UONA LOG nGistiR/PIPELINE — PUSH 
CONDITIONAL JUMEs SUB. YIA REG OR PIPELINE - JSRP 
CONDITIONAL JUMP VECTOR - CJV 

CONDITIONAL JUMPS VIA TREGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT EQUAL 0 -— RFCT 
Reba Pre oibeeCOUNTERENOT EQGUAL O — RPCT 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP PIPELINE AND POP 

LOAD COUNTER AND CONTINUE - LDCT 

Theol £OR “END OF LOOP — LOOP 

CONTINUE = CONT 

THREE WAY BRANCH —- TWB 

HELP with this program 

RETURN to higher level 


Enter a 


DimyPmvovoavsrrowr OUP WNrH OC 


d 
The sequencer code is already set. 
Do you want to change it? 


yy 


(EX. 


AM2910"°SEQGUBNCER CONDTEIONSSE LECT MENU 


You have chosen an AM2910 Sequencer Command which requires a 
conditional test 


What do you want to do next? 
for FORCED PASS = uneenditional 


for FORCED FAIL 


Type a P 
F 
T to TEST the condition 
H 
R 


for HELP with this: proer.am 
to RETURN to higher level 
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AMZIOP=CONDITIONAL TEST MENU 


There are two steps to selecting a test condition 
1) select a REGISTER to be used 


2) select a 


TEST on that register 


This menu selects the register ot two special tests 
which combine two registers 


What do you want to do? 


1 Om 
for 
for 
Lor 
for 
Lor 


Type a 


—_ 


a) fo ne Go iD 


the Micro status register 

the MACRO Status Register 

the Immediate Status Inputs 
Immediate Sign EXOR MACRO Sign 
Immediate Sign EXNOR MARCO Sign 
HELP with this menu 


to RETURN to a higher level 


on 


4 


AM2904 CONDITIONAL TEST MENU 


What condition do you want reflected by the condition? 


Type a for (SIGN exor OVR) or ZERO 
for (SIGN exnor OVR) and not ZERO 
for (SIGN exor OVR) 
for (SIGN exnor OVR) 
for ZERO 
Tor noe ZERO 
for OVR 


for not OVR 

for (CARRY or ZERO) 

for (not CARRY) or (not ZERO) 
for CARRY 

for not CARRY 

for (not CARRY or ZERO) 

for (CARRY or not ZEne 

for SIGN 

for not SIGN 

for HELP with this menu 

to RETURN to a higher level 


YVR AMUaADP OANA AIHhWNH © 


B2 


REMINDER INFORMATION 
You have chosen one of the following 2910 Sequencer Commands 
RFCT REPEAT LOOP, COUNTER NOT EQUAL QO 
CIPEeeCONDMELITONADSIUMP PIPELINE AND POP 
LOGeslEort OR END OF LOOP 
TWB THREE WAY BRANCH 
These commands MUST be preceded by a 


PUSH — PUSH/CONDITIONAL LOAD REGISTER/COUNTER 


Press enter to continue 


83 


MASTER AM2910 SEQUENCER MENU 


XXXXXXXXXXXXXXXX XXOXOLOILXXOX1OOL XXXXXXXXXXXX110I1 
Pt on d5d9g iotetd 


The X s indicate bits which are not yet defined. 
What do you want to do next? 
Enter a OQ to select SEQUENCER COMMAND 


H “tor HELP with tats program 
R to RETURN to system 
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AM2910 SEQUENCER COMMAND MENU 
Which AM2910 Sequencer Command do you wish to Chose? 


wee ce non 7 

CONDITIONAL JUMP SUBROUTINE - CJS 

JUMP MAP - JMAP 

CONDERLONA Te JUMPeriPE LINE = CJP 

PUSH, COhNueLrTOnNALwLOAD REGISTER/PIPELINE - PUSH 
CONDI LON ee UMreeoibe ey LA REG OR PIPELINE - JSRP 
CONDITIONAL JUMP VECTOR - CJYV 

COM Use DONS leewuUrme ey TAeweRHGIESTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT EQUAL 0° — &RFCT 
Bee E At eee er bone ec COUNTER SNORSEQGUAL 0 => RPCT 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP PIPELINE AND POP 

LOAD COUNTER AND CONTINUE - LDCT 

thot FOR END OF LOOP — LOOP 

CONTINUE - CONT 

THREE WAY BRANCH — TWB 

HELP with this program 

RETURN to higher level 


Enter a 


Sma mvuoawrowrtoaurwonrs- oOo 


Ui 
The sequencer code is already set. 
Do you want to change it? 


af 
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AM2910 SEQUENCER BRANCH ADDRESS MENU 


You have chosen a command which requires a value in the 
register/counter 


What do you want to do next? 


ENTER YOUR BRANCH ADDRESS FIELD 
H for HELP with this program 
R to RETURN to a higher level 
dataat, 
This is the address being used.fff 
Invalid input, the max hex number is 3FF. 
Press enter to continue 
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AM2910 SEQUENCER BRANCH ADDRESS MENU 


You have chosen a command which requires a value in the 
register/counter 


What do you want to do next? 


ENTER YOUR BRANCH ADDRESS FIELD 
Heeetor HEEP wrth this program 
R to RETURN to a higher level 
3233 
This is the address being used.333 
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AM2910 SEQUENCER CONDITION SELECT MENU 


You have chosen an AM2910 Sequencer Command which requires a 
conditional test 


What do you want to do next? 
for FORCED PASSHsuncondi176na | 


for FORCED FAIL 


Type a P 
F 
T to TES? the conditron 
H 
R 


for HELP with this program 
to RETURN to higher level 
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AM2904 CONDITIONAL TEST MENU 


There are two steps to selecting a test condition 
1) select a REGISTER to be used 
2) select a TEST on that register 


This menu selects the register ot two special tests 
which combine two registers 


What do you want to do? 


Type a QO for the Micro status register 

for the MACRO Status Register 

for the Immediate Status Inputs 

for Immediate Sign EXOR MACRO Sign 
for Immediate Sign EXNOR MARCO Sign 
for HELP with this menu 

to RETURN to a higher level 


Ome wWNHY 


iso 


REMINDER INFORMATION 


You have chosen one of the following AM2910 Sequencer 
Commands: 


JIRP JUMP REGISTER OR FPIPELINE 
RPCT REPEAT PEPELINE COUNT E Regn Clea @ UA rae 


These commands MUST be preceded by a 
LDCT - LOAD COUNTER AND CONTINUE 


Press enter to continue 
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MASTER 


PEAK AAA AAXAKAAXXAX 
tie 


The X s indicate 


What do you want 
Enter a_ QO 

H 

R 


AM2Z2910 SEQUENCER MENU 


POA, OxXTOOR  XkXTTOOLIO01IOII) 
end P34 


bits which are not yet defined. 
LO, ado next? 
to select SEQUENCER COMMAND 


for HELP with this program 
to RETURN to system 


al 


AM2910 SEQUENCER COMMAND MENU 
Which AM2910 Sequencer Command do you wish to Chose? 


JUMP ZERO JZ 

CONDITEONALS JUMP SUBROULINES=cJs 

JUMP MAP - JMAP 

CONDITIONAL JUMP PIPELINE - CJP 
PUSH/CONDITIONAL LOAD REGISTER/PIPELINE - PUSH 
CONDITIONAL JUMP SUB. VIA REG OR PIPELINE =i ae 
CONDITIONAL JUMP VECTOR — Cay 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
REPEAT LOOP, COUNTER NOT EQUAL 0 - RFCT 
REPEAT PIPELINE, COUNTER NOT EQUAL 0 —-Serce 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP PIPELINE AND POP 

LOAD COUNTER AND CONTINUE — LDCT 

TEST FOR END?OF SLOOP] shoor 

CONT UNDE? —SCONT 

THREE WAY BRANCH —- TWB 

HELP with this program 

RETURN to higher level 


Enter a 


Grea mvuaQqwnmnprprewowrtoarnrwnrc0 


f 
The sequencer code is already set. 
Do you want to change it? 


a 


a2 


AM2910 SEQUENCER BRANCH ADDRESS MENU 


You have chosen a command which requires a value in the 
register/counter 


What do you want to do next? 


ENTER YOUR BRANCH ADDRESS FIELD 
H for HELP with this program 
R to RETURN to a higher level 
zal) 
This is the address being used.21l 


a3 


AM2910 SEQUENCER CONDITION SELECT MENU 


You have chosen an AM2910 Sequencer Command which requires a 
conditional test 


What do you want to do next? 
for FORCED PASS - unconditional 


for FORCED FAIL 


Type a P 
F 
T to TEST the condrtiona 
H 
R 


for HELP with this program 
to RETURN to higher level 
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AM2904 CONDITIONAL TEST MENU 


There are two steps to selecting a test condition 
1} select a REGISTER to be used 
2) select a TEST on that register 


This menu selects the register ot two special tests 
which combine two registers 


What do you want to do? 


Type a O for the Micro status register 

for the MACRO Status Register 

for the Immediate Status Inputs 

for Immediate Sign EXOR MACRO Sign 
for Immediate Sign EXNOR MARCO Sign 
for HELP with this menu 

to RETURN to a higher level 


DWimht WN 


aD 


AM2904 CONDITIONAL TEST MENU 


What condition do you want reflected by the condition? 


Type a 


SU ymoawnrerwoowoninahlbwnNndr © 


for (SIGN exor OVR) or ZERO 
for (SIGN exnor OVR) and not ZERO 
for (SIGN exor OVR) 

for (SIGN exnor OVR) 

for ZERO 

FORO vee ho 

for OVR 

for not OVR 

for )( CARHY sor. Zh ro 

for (not CARRY) orwiGme: ZENO, 
for CARRY 

TOr not CARRY 

for (not CARRY or ZERO) 

for (CARRY “or not ZERO 

forts GaN 

fOr NOt. SEGN 

for HELP with this menu 

to RETURN to a higher level 
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REMINDER INFORMATION 
You have chosen one of the following 2910 Sequencer Commands 
UCL een ee EAL LOOP COUNTER NOT EQUAL O 
CIREw CONDITIONAL JUMP PIPELINE AND POP 
LOCke Thal FOR ENDS OF LOOP 
TWB THREE WAY BRANCH 
These commands MUST be preceded by a 


PUSH - PUSH/CONDITIONAL LOAD REGISTER/COUNTER 


Press enter to continue 


oF 


MASTER AM2910 SEQUENCER MENU 


XXXXXXXXXXXXXXXX XXLOLIIIXXOX1001 xXxlOOOO1LOOOLIIILL 
Cire efd9 ellf 


The X s indicate bits which are not yet defined. 
What do you want to do next? 
Enter a OQ to select SEQUENCER COMMAND 


H tor HELP with this program 
R to RETURN to system 
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AM2910 SEQUENCER COMMAND MENU 


Which AM2910 Sequencer Command do you wish to Chose? 


Enter a 


VYPuaoAMVUAwWDPoOoaonrnoaunhbpwonr oO 


TUM O ZERO = JZ 

CONDITEONAL. JUMP SUBROUTINE = CJS 

JUMP MAP = "IMAP 

COND LTEONAL JUMP SPEEELINE -.¢€JP 

pied, CONDITPEONALSEOAD REGISTER/PIPELINE - PUSH 
COI TeONAbDeUMiewseUoee VIA REG OR PIPELINE - JSRP 
CONDITLONAL JUMP VECTOR — CJY 

CONDITIONAL JUMP VIA REGISTER OR PIPELINE 
Rees eLOUGr= COUNTER NOT EQUAL 0 = RFCT 

Ree oAt wer LINE COUNT BR NOL EQUAL 0 — RPCT 
CONDITIONAL RETURN FROM SUBROUTINE 

CONDITIONAL JUMP PIPELINE AND POP 

POA COUNTER AND CONTINUE = LDCT 

five eOon en Ny “OL LOOr = LOOP 

CONTINUE = CONT 

Pane ev Are D RANCH. —— LW 

HELP with this program 

RETURN to higher level 


gi 


KK“ OF 


MASTER 


XXXXXXXXXXXXXKXX 
fhe 


The X s indicate 
What do you want 
Enter a QO 

H 

R 


o you really want to 


AM2Z2910 SEQUENCER MENU 


XXIOLITIXXOXTOCGH  xXx1000010CO ae: 
efdQ ellf 


bits which are not yet defined. 
to do next? 

to select SEQUENCER COMMAND 

for HELP with thsi proe¢cram 

to RETURN to system 


leave? 
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The following is a record of a terminal session running the ALU module. 


% test2 
MASTER AM29203 ALU MENU 


XXXXXXXXXXXXXXXX KXKXKXXXXKXKXKXK XXXXXKXKXXKXKXXX 
ffff feast fat t 
The X s indicate bits which are not yet defined 
The defaults for the AM29203 ALU are: 
Register Address Select - bits 47-45 - A,B pipeline = 
al 
Instruction Enable - bit 44 - Disable = 1 
Omtput Enable - bit 43 - Disable = 1 
poumece — bits 42-40 = DAQ = Til 
Destination —- bits 39-36 - YBUS = Jill 
MaleruMmetatoms.— bits 35—32 — OR = JI111 


What do you want to do next? 

type a B to choose ALU FUNCTIONS 
S to choose SPECIAL FUNCTIONS 
H for HELP with this program 
R to RETURN to higher level 
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AM29203 ALU BASIC FUNCTION SELECT 


Enter the value corresponding to the function you wish to 
perform 

High 

S - R - 1 + Carry In 

Re Se et ae 

S + Cdpuy In 

Carry In 

NOT SS). + @@arry iin 

+ Carry sian 

(NOTSER )-f-Carry in 

Low 

(NOT R) AND S 
EXCLUSIVE OR =s 
EXCLUSIVE OR Gs 

AND §S 

NOR §S 

NAND S 

ORs 

for HELD Witietnis pregran 
to RETURN to higher level 


NHayAa ay aMSB BBM NAY 
boo th Th Tens = 


VProOmMmMoaQ1wmnr oowonrnoaohwnde © 
OMaaww sw 


202 


You have 
F 


ti at Ph 


F 
F 
F 


AM29203 ALU SOURCE MENU 


chosen one of the following AM29203 ALU functions: 
High 

het Carry in 

CNG hy) + as@-a raevee ln 
LOW 


Porethese functions, the only allowed AMZ9203 ALU Sources 


are: 
Operand R Operand § Mnemonic 
RAMA Q Register RAMAQ 
Direct A Q Register DAQ 
Type a 2 for RAMAQ 
6 for DAQ 
Heetor HELP with this program 
R to RETURN to a higher level 
6 
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AM29203 ALU DESTINATION MENU 


Enter the value corresponding to the destination you 


desire 


UGRmAnRaMoIQq nr owrnaayhrPwoneK oO 


RAMDA -—- F to RAM, Arithmetic Down Shift 
RAMDL — F to RAM, Logical Down Shite 
RAMQDA - Double Precision Arithmetic Down Shift 
RAMQDL ~- Double Precision Logical Down Shift 
RAM -—- F to RAM with parity 
QD = .F to Yowvown shirt 6 
LOADQ@ — F GomQewith parity 
RAMQ - F to RAM with parity 
RAMUPA — FetoU RAM, Arithmetic Upeshitt 
RAMUPL - F to RAM, Logical Up Shift 
RAMQUPA - Double Precision Arithmetic Up SHift 
RAMOQUPL = Double Procision Logical Up Simi 

= Eto TY only 

sleet Oe ap dvl pao Hila toane 

SIGNEXT = SiO0r tony (1) 
RAMEXT = E tomy. 3 lene. tema ioe 
Instruction Register 
Main Memory 
for HELP with this program 
to RETURN to higher level 
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You have chosen a down shift for this microword. There are 
memrossible shift patterns, coded 0 thru F in bits [9 

thru I6. Choose the shift pattern you desire from the 
following set: 


zero = 0 => RAMn, we —-7 eon 
one = il -> RAMn, a 2 On 
two = 0 aa aie RAO —— Me, ‘ieee > On 
three = ll = RAM RAMO -> Qn 
four = Mc -> RAMn, RAMO -> Qn 
five = Mn -> RAMn, RAMO => On 
S1xX = 0 =e RAMnE RAMO -> Qn 
seven = 0 ee AM his RAO => On, SO = >" Me 
eight = RAMO -> RAMn, CU ons RAMO -> Mc 
nine = iG seta aA ND CU? On. RAMU S—> Mec 
A = RAMO -> RAMn, O0F => On 
B = bos =e Anne RAMO -> Qn 
C = Mc -> RAMn, RAMO -> Qn, 20 sic 
D = QO -> RAMn, RAMO -> Qn, OO ~=> Mc 
E = In exor [IQOvr -> RAMn, RAMU ==> On 
F = Q0 -> RAMn, RAMO -> Qn 


H to get help with this procedure 
N to back up one frame. 
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AM29203 ALU INSTRUCTION AND OUTPUT ENABLE MENU 


Do you want the ALU results to appear on the Y-bus? 
Type an YY tor YES 
Type a N for NO 


y 
Do you want to change the contents of any ALU 


register 
during this ALU operation? 


Type an Y for YES 
Type an N_ for NO 


106 


MASTER AM29203 ALU MENU 


AX XOOLICCIOIVOOOL Mee ee COCO MAMA ARAARAAAAAA 
e650 ffed hetero 

The X s indicate bits which are not yet defined 
The defaults for the AM29203 ALU are: 

Register Address Select - bits 47-45 - A,B pipeline = 
ad 

instruction Enable -—- bit 44 - Disable = 1 

Output Enable - bit 43 - Disable = 1 

Seurce — bits 42-40 — DAQ = lll 

Destination - bits 39-36 - YBUS = llll 

Poor unct LOneaebilesmso-s2 — OR = J111 


What do you want to do next? 
type a B to choose ALU FUNCTIONS 
S to choose SPECIAL FUNCTIONS 
H for HELP with this program 
R to RETURN to higher level 
r 
Do you really want to return to mastermenu? 


By 
% test2 


Ov 


MASTER AM29203 ALU MENU 


XXXXXXXXXXXXXXXX XRRXAKXXXKAKAXXKXKK™ NNR NA 
fot dar fot foe ff tet 

The X s indicate bits which are not yet defined 
The defaults for the AM29203 ALU are: 

Register Address Select - bits 47-45 - A,B pipeline = 
Piet 

Instruction Enable - bit 44 - Disable = 1 

Output Enable - bit 43 - Disable = 1] 

Source - bits 42-40 — DAQ = lil 

Destination —="Ditseeg- 36 = eyo — ne 

ALU FunctUvon — “bats 35 -Ss2°- One — ian 


What do you want to do next? 
type a B to choose ALU FUNCTIONS 
S to choose SPECIAL FUNCTIONS 
H for HELP with this Drocran 
R to RETURN to higher level 
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Enter the 


perform 


SrA MVUADPSFPNOWANOUADLWNH ZL OC 


AM29203 ALU SPECIAL FUNCTION MENU 
value corresponding to the function you wish to 


Unsigned multiply 

BCD to Binary Conversion 

Multapreeirsion BCD to Binary Conversion 

Two’s Complement Multiply 

Decrement by 1] or 2 

Increment by 1 or 2 

Sign/Magnitude to Two’s Complement Conversion 
Two’s Complement Multiply 

BCD Divide by 2 

Single Length Mormalize 

Binary to BCD Conversion 

Multiprecision Binary to BCD Conversion 
Double Length Normalize; First Division 

BCD Add 

Two’s Complement Divide 

BODesUberact FF =| R= § = 1 + Carry In BCD 
Two’s Complement Divide Correction and Remainder 
BCOmoUbGieack sof eS 9)-— Rk — ] “+ Carry In BCD 
for HELP with this menu 

to RETURN to higher level 
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AMZ9203 “AEU SOURCE SE ane? 
You have chosen an AM29203 ALU Special Function 


What sources do you want to use 


Operand R Operand S$ Mnemonic 
Enter a OQ RAMA A RAM B RAMAB 
1 RAM A DIREC IME RAMADB 
4 DIRECT A RAM A DARAMB 
5 DtRee pA DIRECT B DADB 
H for HELP with this menu 
R to RETURN to a higher level 


0 


AM2Z29203 ALU INSTRUCTION AND OUTPUT ENABLE MENU 


Do you want the ALU results to appear on the Y-bus? 
Type an Y for YES 
Type a N for NO 


y 
Do you want to change the contents of any ALU 


register 
during this ALU operation? 


Type an Y for YES 
Type an N for NO 


eae 


The default source selection is Source A - pipeline, 
Source B - pipeline, 


Enter the value corresponding to the register address 
you desire 


SODOP WWF CO 


AM29203 ALU REGISTER ADDRESS MENU 


Source A 
Pipeline 
Instruction 
Pipeline 
Instruction 
Pipeline 
Instruction 
Pipeline 
Instruction 


Destination C 


Source B 
Pipeline 
Pipeline 
Inst rueeven 
Instruction 
Pipeline 
Pipeline 
Instruction 
Instruction 


Deke 


- pipeline 


Destination C 


Pipeline 
Pipeline 
Pipeline 
Pipeline 
Instruction 
Instruction 
Instruction 
Instruction 


AMZ IZ06 VALU MRAMeAmREGISTER SELECT 


Enter the value corresponding to the RAM A 
Register 
you wish to select 


O RAMA A Register Q 

1 RAMA A Register l 

2 RAMA A Register 2 

3 RAMA A Register 3 

4 RAMA A Register 4 

DS RAMA A Register 5 

6 RAMA A Register 6 

7 RAMA A Register 7 

8 RAMA A Register 8 

9 RAMA A Register 9 

A RAMA A Register A 

B RAMA A Register B 

C RAMA A Register C 

D RAMA A Register D 

E RAMA A Register E 

F RAMA A Register F 

Pept or= Hew e wa tietnts menu 
R to RETURN to a higher level 


MASTER AM29203 ALU MENU 


OOLLOOOLOLLIOOOO XXXXXKXXXXXKXXKKXXKXK XXKXOLOLXXXXXKXKX 
3170 fio dod f 

The X s indicate bits which are not yet defined 
The defaults for the AM2Z9203 ALU are: 

Register Address Select - bits 47-45 - A,B pipeline = 
Peel 

Instruction Enable - bit 44 - Disable = 1 

Output Enable - bit 43 - Disable = Ii 

Source - bits 42-40 - DAQ = Ill 

Destination — bits 39-366 —8) 005 =) ier 

ALU Funetion — bits 35-325. Cnet lee 


What do you want to do next? 
type a B to choose ALU FUNCTIONS 
S to choose SPECIAL FUNGEDONS 
H for HELP with thus) pregian 
R to RETURN to higher level 


o you really want to return to mastermenu? 


y 
D 
_ 
% test2 
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MASTER AM29203 ALU MENU 


PO KN OK RA NAAN AMMAKKAXXXX XXXXXXNXXXXKXXXX 
foie foil & festa tts 

The X s indicate bits which are not yet defined 
The defaults for the AM29203 ALU are: 

Register Address Select - bits 47-45 - A,B pipeline = 
ed 

Instruction Enable - bit 44 - Disable = 1 

Output Enable — bit 43 — Disable = 1] 

source — bits 42-40 — DAQ = 1l1l 

Destination —- bits 39-36 -—- YBUS = 1111 

Mh meeunet lone bLESeso-o2 =) OR = lil 


What do you want to do next? 
type a B to choose ALU FUNCTIONS 
B  ebO choose SPECIAL FUNCTIONS 
Hee etOnm HELP with this program 
R to RETURN to higher level 


Enter the 
perform 


AM29203 ALU BASIC FUNCTION SELECT 


value corresponding to the function you wish, 


Cr = 
If = 
oe 
See 
4 § + 
5 ¢ 

6 R + 
tne = 
Soe 
9 F= 
A F = 
B F = 
C F = 
D F = 
E Fk = 
F F = 
He shor 
R 


High 

S  — Reel + Carryaeen 
R=) S S22 eles Carian 
So Carry in 


Carry In 


NOTTS S ) pee aiery in 


Carry In 

(NOT R) + Carry In 
Low 

(NOT R) AND S&S 


R 
R 
R 
R 
R 


R 


EXCLUSIVE OR S$ 
EXCLUSIVE OR 5S 
AND S 

NOR $ 

NAND S 

OR S$ 


HEL p with this program 


to RETURN to higher level 


AM29203 ALU SOURCE MENU 


The source control default is DAQ 


Operand R Operand § Mnemonic 
Enter a OQ RAMA RAMB RAMAB 
1 RAMA Direct B RAMADB 
2 RAMA Q Register RAMAQ 
4 Direct A RAMB DARAMB 
See Da rect A DirectB DADB 
6 Direct A Q Register DAQ 
if Instruction Register 
E Pipeline Register 
H for H with this program 
R to RETURN to higher level 
5 


a? 


AM29203 ALU DESTINATION MENU 


Enter the value corresponding to the destination you 


desire 


UOEHasMUIADPOWNANANUHPWNHeEO 


RAMDA - F to RAM, Arithmetic Down Shift 
RAMDL - F to RAM, Logical Down Shift 
RAMQDA - Double Precision Arithmetic Down Shift 
RAMQDL —- Double Precision Logica l@@own shies 
RAM - F to RAM with parity 
QD — Sheets Ywevovnecnit t 7 
LOADQ@ = FF tovQewith parity 
RAMQ - F to RAM with parity 
RAMUPA — F toPRAM, “ArithmetvesUp Shite 
RAMUPL - F to RAM, Logical Up Shift 
RAMQUPA - Double Precision Arithmetic Up SHift 
RAMQUPL ="DoubVe Precision tbegical Upc anise 
=the toy only 
= Ff Shot Yao polit cae 
SIGNEAT =o 200 “tery ta) 
RAMEXT - F to Y, Sign extend LSB 
Instruction Register 
Main Memory 
for HELP with this program 
to RETURN to higher level 


AM29203 ALU INSTRUCTION AND OUTPUT ENABLE MENU 


Do you want the ALU results to appear on the Y-bus? 
Type an Y_ for YES 
Type a MN for we 


y 
Do you want to change the contents of any ALU 


register 
during this ALU operation? 


Type an  Y for YES 
Type an N_ for NO 


LS 


MASTER AM29203 ALU MENU 


XXXOOLOLOLIILIOO XXXXXXXKKXKXAM AK NX XX 
e517 fire fait ft 

The X s indicate bits which are not yet defined 
The defaults for the AM29203 ALU are: 

Register Address Select - bits 47-45 - A,B pipeline = 
Palit 

Instruction Enable — bit 44 — Disable = 1 

Output Enable ~- bit 43 - Disable = 1 

Source = bits 42-407 )AG7— vee. 

Destination - bits 39-35 —= YBUS — tite 

ALU Funetion -— bits 35-329], 0R 7-2 


What do you want to do next? 
type a B to choose ALU FUNCTIONS 
S to choose SPECIAL FUNCTIONS 
H for HELP with this program 
R to RETURN to higher level 
ic 
Do you really want to return to mastermenu? 


y 
% testZ 


P20 


MAS PER AMZOS20 35 ALU MENU 


XXXXXXXXXXXXXXXX KXKXXXXXKXXXKXKKKKX 


fo fete he font f 


XXXXXXXXXXXXXKKXK 
frit 


The X s indicate bits which are not yet defined 
The defaults for the AM29203 ALU are: 
Register Address Select - bits 47-45 


il 


What 


iis truction Enable —= bit 44 -—- Disabl 


Output 
Source 
Destin 


Enable - bit 43 - Disable = ] 


- bits 42-40 - DAQ = lll 
ation - bits 39-36 - YBUS = ill 


Maflerunetion — bres S5S—32 OR = Pt 


do you 
type a 
S 
H 
R 


want to do next? 
B to choose ALU FUNCTIONS 
to choose SPECIAL FUNCTIONS 
foredt be ewith this prog. am 
to RETURN to higher level 


PZ 


A,B pipeline 


e = l 


et 
1 


Enter .the 
perform 


AM29203 ALU BASIC FUNCT RGR SE PicyT 
value corresponding to the fumetion you wish ee 


High 

So Relies Carry 
R = S355 + Carryaeen 
S tt Capi y in 

Carry In 

NOT S) + Carry In 

Carry In 

(NOT Rose Carry sin 
Low 

(NOT R) AND S 
EXCLUSIVE OR sS 
EXCLUSIVE ORS > 

AND S 

NOR S 

NAND S 

OR S 

for HELp with this program 
to RETURN to higher level 


Wo ot 


+ + 


+ 


oUt Wb 


ey ME) ey ney ney ey ey yy yy 


Sr AMUIADWDP OOMONAARWNHreE O 
Ua wmWaD wa 


The Carry into the least significant stage of the ALU 
meameontrolled by bits ([l2 and fil, and sometimes bits 
I5, I3, I2, and Il. There are seven possible choices: 


Type a zero to select ZERO as the carry-in. 

Type a one to select ONE as the carry-in. 

ny pe altwonto select Cx, the Z output of the 29203. 
Type a three to select the carry bit from the micro reg 
Type a four to select the micro carry bit complemented 
Type a five to select the MACRO carry bit 

Type a six to select the MACRO carry bit complemented 


Type an H for help. 


eS 


AM29203 ALU SOURCE MENU 


The source control default is DA@ 


Operand R Operand § Mnemonic 
Enter a QO RAMA RAMB RAMAB 
1 RAMA Directs. RAMADB 
2 RAMA Q Register RAMAQ 
4 Direct A RAMB DARAMB 
5 Direct A DirectB DADB 
6 Direct A Q Register DAQ 
af Instruction Register 
Ie Pipeline Register 
H for H with this program 
R to RETURN to higher level 
0 


AM29203 ALU DESTINATION MENU 


Enter the value corresponding to the destination you 


desire 


YO A NTMWOoOODTP OWI MSP UPWNFrHO 


RAMDA - F to RAM, Arithmetic Down Shift 
RAND = Hato RAM. Logical Down Shift 
RAMQDA -—- Double Precision Arithmetic Down Shift 
RAMQDL - Double Precision Logical Down Shift 
RAM —- F to RAM with parity 
CDM F “ort. Downe ond {tee 
EQAD@ = (F tor QO wath parvey 
RAMQ - F to RAM with parity 
mare Aes Feto RAM, Arithmetic Up Shift 
RAMUPL - F to RAM, Logical Up Shift 
RAMQUPA —- Double Precision Arithmetic Up SHift 
RAMQUPL - Double Procision Logical Up SHift 
et vom con ly 
—~ i) tome. Up sma t <Q 
SUG NG X= 5 LOO Mtoe Y (7) 
HAMEN) “i SCO Yumoien extend LSB 
Instruction Register 
Main Memory 
Mogae ntebe with this program 
to RETURN to higher level 


ea 


You have chosen a down shift for this microword. There are 
16 possible shift patterns, coded 0 thru F in bits I9 


H to get help with this procedure 
N to back up one frame. 


WAS. 


thru 16. Choose the shift pattern you Mesire fromthe 
following set: 
zero = 0 = >) RAtinG CG Se on 
one = 1 ~> RAMn, Pon 
two = 0 -> RAMn, RAMO -> Mc, Mn —-> Qn 
three = 1 —-> RAMn, RAMO -> Qn 
four = Me => 9HADing RAMO -> Qn 
five = Mn —-> RAMn, RAMO -> Qn 
Sl1lx = 0 —-> RAMn, RAMO -> Qn 
seven = 0 ~> RAMn, RAMO -> Qn, OC > Bic 
eight = RAMO -> RAMn, GUs => Qn; RAMU > Bic 
nine = Mc -> RAMn, QUe -~> Qn, RAMOS > eile 
A = RAMO -> RAMn, OC= —> sen 
B = ro => TRaAtine RAMO -> Qn 
C = Mc —-> RAMn, RAMO -> Qn, Q@0 =—> Me 
D = QQ -> RAMn, RAMG?— 2 On. Q0 -> Me 
E = In éexor [U0vr > —> shaun RAMO -> Qn 
F = QQ -> RAMn, RAMO -> Qn 


AMewcUomeoU INSTRUCTION ANDP OUTPUT ENABLE MENU 


Do you want 
Type an 
Type a 


yy 
Do you want 


register 
during this 


Type an 
Type an 


the ALU results to appear on the Y-bus? 
Yor hore ris 
Neetor NO 


to change the contents of any ALU 
ALU operation? 


ve foreyvEo 
N for NO 


ie2'7 


The default source selection is Source A - pipeline, 
Source B - pipeline, 


Enter the value corresponding to the register address 
you desire 


SHOP WNHNHe © 


AM29203 ALU REGISTER ADDRESS MENU 


source A 
Pipeline 
Instruct i160 
Pipeline 
Instruction 
Pipeline 
Instruction 
Pipeline 
Instruction 


Destination C 


Source B 
Pipeline 
Pipeline 
Ins t@uce .om 
Instruct lon 
Pipeline 
Pipeline 
Instruction 
Instruction 
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Pipeline 


Destination © 


Pipeline 
Pipeline 
Pipeline 
Pipeline 
Instruction 
Instruction 
Instruction 
Instruct vor 


AM29203 ALU RAM A REGISTER SELECT 


Enter the value corresponding to the RAM A 
Register 


you wish to select 


O RAMA A Register QO 

1 RAMA A Register 1 

2 RAMA A Register 2 

3 RAMA A Register 3 

4 RAMA A Register 4 

5 RAMA A Register 5 

6 RAMA A Register 6 

7 RAMA A Register 7 

8 RAMA A Register 8 

9 RAMA A Register 9Q 

A RAMA A Register A 

B RAMA A Register B 

C RAMA A Register C 

D RAMA A Register D 

E RAMA A Register E 

F RAMA A Register F 

H for HELP with this menu 
R to RETURN to a higher level 


ie 


AM29203 ALU RAM B REGISTER SELECT 


Enter the value corresponding to the RAM B 
Register 
you wish to select 


O RAM B Register QO 

1 RAM B Register 1 

2 RAM B Register 2 

3 RAM B Register 3 

4. RAM B Register 4 

5 RAM B Register 5 

6 RAM B Register 6 

7 RAM B Register 7 

8 RAM B Register 8 

9 RAM B Register 9 

A RAM B Register A 

B RAM B Register B 

C RAM B Register C 

D RAM B Register D 

E RAM B Register E 

F RAM B Register F 

H for HELP with this menu 
R to RETURN to a higher level 
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O1O00000000010010 OLXXXXXXKXXOOO1]L XXXXOOOLI1IL1IOXXXX 


MASTER AM29203 ALU MENU 


4012 ?fe3 


flef 


The X s indicate bits which are not yet defined 
The defaults for the AM29203 ALU are: 
Register Address Select - bits 47-45 - 


Instruction Enable - bit 44 - Disable 
Output Enable - bit 43 - Disable = ] 
source - bits 42-40 - DAQ = lll 
Destination —- bits 39-36 - YBUS = llll 
moe Punetion — bats 35-32 =—"OR = I111 


i 
What 
type a 
> 
H 
R 


1 


Do you really want to return to mastermenu? 


< 


% 


test2 


do you want to do next? 


B to choose ALU FUNCTIONS 
to choose SPECIAL FUNCTIONS 
for HELP with this program 
to RETURN to higher level 


sd 


A,B pipeline 


I 


APPENDIX B 


Program Name: Seqmake 

Purpose: The Makefile used to compile the Sequencer 
module and its submodules. The name 
Seqmake must be changed to makefile before using. 


test3: 2910.0 Gtias-o 
cc 2910.0 weitlsVomsoe test. 


13m 


Program name: 2910.c 
Purpose: Source code for Sequencer module. 


#include “sit G2O.5 fi? 
#include "declare.h” 


/* these defines refer to the logical fields of the 
microword they are used to pass field _ set the fields --note: 
these defines are commented out!! they are provided for 
readability only. 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
* / 


mio KEEPgoing,goback,docu_word[ 24]; 
char cmd_line[80],*pcmd, *pmwd,micro_word([49} ; 


main( ) 


{ 


fd t 1,helpset; 
char CONTINUEcommand([4],am2910command [80]; 


7* Initialize micro_word to ’X’ and docu_word to 0 */ 


micro_word[48] 
Mor (i-0;i < 48; 


regsel 1 
ien_fld 2 

oey_ fld 3 
source _fld 4 
dest _fld 5 
munet ion fld 6 
Cai Wien Vda gs 
LoF4 ft 1d 8 

hom loner band 
PoetOet id ie 
ceu_fld ll 

cem fld 12 
cmden_ fld 13 
shiften_fld 14 
command fld 15 
Sete t ledeale 
breakpoint fld 17 
notused fld 18 
msb_br_fld 19 
Med br 1 idee 
Isblobrveid. 2 
rega fld 22 
regb fld 23 
seq. fidecd 

no_ sub 0 


2 One 
i++) 


Hes 


Micro word) 1 os see ae 
for (1-07 24924. 
docucword{ 1 |e— sve 
KEEPgoing = true; 
helpset = false; 
goback = false; 
while (KEEPgoing :: helpset) /* Need both KEEPgoing and ¥*/ 
{ /* helpset = 0 to get out of*/ 
helpset = false; /* main program section. 17) 
am2910menu(am2910command): /* KEEPgoing is global and kv 
/* can be set from ext proc. */ 
if ( *amZ91l0command == “0 ) 
{ 
COMMANDselect(); 
if (goback) 
{ 
helpset = true; 
goback = false; 
} 
} 
else 
if (*am2910command == ’H’ (1 XamZ91l0command == *’h- | 
f 
i 
helpset = true; 
puts("Help will be coming soon’ v0 
puts("Press enter to continue\0"); 
gets(CONTINUEcommand) ; 
} 
else 
if ((*am2910command == ’R’® (+: > *amZ2olVeonmand -——) ie 
(+ (KEEPgoing == false) ) 
{ 
puts("Do you really want to leave?\0"); 
gets(CONTINUEcommand) ; 
switch( *CONTINUEcommand ) 
{ 
case ’YES’: 
case ’yes’: 
case ’Y’: 
case ’y’: 
KEEPgoing = false; 
break; 
} 
} 
else 
1 
helpset = true; 
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nits Tourmsinoput ts invalwa, enter O0,h,H,r,R only.\Q0" 
sleep(3); 


} 
} /* while */ 


eereit { ): 
} /* procedure am2910master */ 


J KKK KK KKK KKK KKK KK KKK KK KK KK KKK KK KK KKK KK KKK KKK KK KKK KKK KKK KKK 


/ * x / 
/ * AM2910 MENU PROCEDURES *x / 
/ * x / 


J KKK KKK KKK KKK KK KKK KK KK KKK KKK KK KKK KKK KK KK KKK KKK KKK KKK KKK KKK, 


am2910menu(am2910command) 


char *am2910command; 


{ 


puts (erase _screen) ; 

Popes \t\t\tMASTER AM2910 SEQUENCER MENU\n\0"); 

display _word(); 

display_in_hex(); 

display _docu(); 

puts("\tThe X s indicate bits which are not yet 
detained. vin. 0) 3): 

puts("\tWhat do you want to do next?\0"); 

puts("\t\tEnter a 0 to select SEQUENCER COMMAND\O"); 

meoes( ’ \t\t BH for HELP with this program\0”"):; 

mes \t\t R to RETURN to system\0"); 

gets(am2910command) ; 


} /* procedure AM2910menu */ 


SEQUENCERmenu( SEQUENCERcommand ) 
char *SEQUENCERcommand; 


{ 
puts(erase_ screen); 
puts("\t\t\tAMZ910 SEQUENCER COMMAND MENU\n\0"); 
puts("\tWhich AM2910 Sequencer Command do you wish to 
GChose’?\n\0"); 


puts("Enter a JUMPS Zh Ome. O°): 


0 
puts(" 1 CONDITIONAL JUMP SUBROUTINE - CJS\0"); 
puts(" 2 JUMP MAP -— JMAP\0O"); 
puts(" 3 CONDITIONAL JUMP PIPELINE - CJP\0"); 
puts(" 4 PUSH/CONDITIONAL LOAD REGISTER/PIPELINE 


Sion Or). 


puts 59 CONDITIONAL JUMP SUBTe VIA REGeOR 
PIPELINE — JSEP View 


pulls G 6 CONDITIONAL JUMP VECTOR - Cl) 0a. 
puts({” 7 CONDITIONAL JUMP VIA REGISTER OR 
PIPELINE Vem 

Pie s 8 REPEAT LOOP, COUNTERSNG LOU, 
REFCT\G. 32 

puts(" 9 REPEAT PIPELINE, COUNTER NOT EQUAL SOR 
RPC TG 

puts( A CONDITIONAL RETURN FROM SUBROUTINE\O"); 

puts(" B CONDITIONAL JUMP PIPELINE AND POP\O"); 

puss (: C LOAD COUNTER AND CONTINUE — EDCT VO ce 

PUES D TEST FOR END OF LOOP - LOOP\O"); 

puts(" E CONEINUE — COND ay. 

puts || F THREE WAY BRANCH — TWB\0"); 

pues H HELP with this program.o0 |] 

puts(” R RETURN to higher level\0"); 


gets (SEQUENCERcommand) ; 


} /* procedure SEQUENCER menu *X*/ 


BRANCHmenu(branchselect ) 


char *branchselect; 


{ 
puts(erase_ screen); 
puts("\t\tAM2910 SEQUENCER BRANCH ADDRESS MENU\n\0"); 
puts("You have chosen a command which requires a value in 

the\0"); 

puts("register/counter\n\0"); 
puts("What do you want to do next?\n\0"); 
puts("\tENTER YOUR BRANCH ADDRESS FIELD\O"); 
puts Ve H for HELP with this program\0"); 
puts("\t R to RETURN to a higher level\0"); 
gets(branchselect); 

} /* procedure branch menu */ 


PUSHmenu () 


char CONTINUEcommand([ 4]; 

puts(erase screen); 

puts("\t\t\tREMINDER INFORMATION (a Ge) 

puts("You have chosen a PUSH/CONDITIONAL LOAD 
REGISTER/COUNTER -—-PUSH\O oe 
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puts("\tas the AM2910 Sequencer Command\n\0") ; 
puts("This command MUST precede the following 

commands: \n\07 § ; 
Pomes« \t\tRPCT REPEAT LOOP, COUNTER NOT EQUAL 0\0"): 
Pimes( \t\tCJPP CONDETIONAL JUMP PIPELINE AND POP\O”"); 
Peers. \t\tLOOP TEST FOR END OF LOOP\O”); 
pucs('\t\tTWB THREE WAY BRANCH\n\n\n\0"); 
puts( Press enter to continue\0"); 
gets(CONTINUEcommand) ; 


} /* procedure PUSHmenu */ 


LDCTmenu () 


aN 


char CONTINUEcommand[ 4]; 

puts(erase_screen) ; 

muts« \t\t\tREMINDER INFORMATION\n\0”"); 

puts("You have chosen a LOAD COUNTER AND CONTINUE -LDCT- 
as the\0"); 


puts("\tAM2910 Sequencer Command\n\0"); 
puts("This command MUST precede the following: \n\0"); 
pores (" \t\tJRP CONDI HONAI J UMP "REGISTER OR PIPELENE\O’ 3; 
mies« \t\tRPCT REPEAT PIPELINE, COUNTER NOT EQUAL 

Ne en Nah 2 ee 
Puts ( 'Press enter to continue\0"); 
gets (CONTINUEcommand) ; 


} /* procedure LDCTmenu */ 
NEEDPUSHmenu( ) 


char CONTINUEcommand/4]; 
puts(erase_ screen); 
puts("\t\t\tREMINDER INFORMATION\n\0"); 
puts("You have chosen one of the following 2910 Sequencer 
Commands vn. 0") ; 
fies Gt tRPrCr REPEAT LOOP, COUNTER NOT EQUAL 0\0"):; 
mimes \t\tCJPP CONDITIONAL JUMP PIPELINE AND POP\O0"); 
mes Vt\tLOOP TEST FOR END OF LOOP\0™); 
puts("\t\tTWB THREE WAY BRANCH\n\0"); 
puts("These commands MUST be preceded by a\n\0"); 
puts("\t\tPUSH - PUSH/CONDITIONAL LOAD 
REGESPER, COUNTER\n\n\n\0"); 


ene 


puts("Press enter Vomcontinue (os 
gets(CONTINUEcommand) ; 


} /*® procedure need push menu */ 


NEEDLDCTmenu () 


char CONTINUEcommand([ 4] ; 
puts(erase_screen); 
puts("\t\t\tREMINDER INFORMATION\n\0"); 
puts("You have chosen one of the following AM2910 

Sequencer Commands: \n\0"); 
pUuUtS © \ Et Geo Re JUMP REGISTER OR PIPELINE\O"); 
puts("\t\tRPCT REPEAT PIPELINE, COUNTER ove bet Oun 

O\ non ee 

puts("These commands MUST be preceded by a\0"); 
puts("\t\tLDCT - LOAD COUNTER AND CONTINUE\n\n\n.0 oe 
puts("Press enter to continue\0"); 
gets(CONTINUEcommand); 


} /* need_ldct menu */ 


CONDITIONmenu (CONDITIONcommand) 


char *CONDITIONcommand; 


{ 
puts(erase_screen); 
puts("\t\tAMZ910 SEQUENCER CONDITION SELECT MENU\n\0"); 
puts("You have chosen an AM2910 Sequencer Command which 

requires a\0"); 

puts( "\tconditionalevest a). 
puts( "What do you want) tordo ne-b 4 7 0 2 
puts("\tType a P for FORCED PASS — unconditional oe 


puts | Ne F for FORGED FAIL. OC oe 

puts ( Vet T to TEST the conditwon. 0] 
puts("\t H for HELP with this program\0"); 
puts) Vt R to RETURN to higher level\0"); 


gets(CONDITIONcommand) ; 


} /* procedure condition menu */ 


tastimenu( TESTiselect) 


char *TESTlselect; 


{ 


puts(erase_ screen); 
puts("\t\t\tAM2904 CONDITIONAL TEST MENU\n\0" ); 


puts (" There are two steps to selecting a test 
condition\0"); 
puts(" 1) select a REGISTER to be used\0"); 
muts (" Zouece Lect mae ihotachmt hat. register\n\0" }; 
puts(" This menu selects the register ot two special 
tests\0"); 
mats (" which combine two registers\n\0"); 
puts (" What do you want to do7?\n\0"); 
puts (” iype a0 tor the Micro status register\0":: 
puts (" I Stor the MACRO’ Status Register \0'° ); 
puts (" 2 for the Immediate Status Inputs\0",; 
puts(" 3 for Immediate Sign EXOR MACRO 
Siem os 
mats (" 4 for Immediate Sign EXNOR MARCO 
Seige WO! 4s 
mats (" H for HELP with this menu\0"); 
puts (" R to RETURN to a higher level\0O"): 


gets(TESTlselect) ; 
} /x procedure TESTlilmenu */ 


Gemd 1 set(pchar) 
/* This is the first level cond. code select, and matches 
TES Timenu. —* 
char xpchar; 
{ 
int next_level; 
char *field,field_ line[4]; 
next level = TRUE; 


Switch (*pchar) 


case ’0’: /* Micro status register selected. */ 
ba tclearm OS m0 des 
bit set(I04 04); 
/* Note that I04 can be cleared for many cases, see Tbl. 4, 
FOO ero a 7 
break; 


case °1’: /* Macro status register. *x/ 
bit_set(I05 04); 
bit _clear(104_ 04); 
break; 


iS 9 


Case 


casc¢ 


Case 


ee /* Immediate Inputs. */ 
bit set i 105.04); 
bit _set(I04_ 04); 


break; 
"3? /* Imm... sign Cxor Moke ug me 
*¥pchar = ’e’; 


field _set(condtest_fld,3,pchar) ; 


next level = FALSE; 

break; 

74’: /xk Imm. sign exnor MSR sign */ 
Kpichak =~ af = 


field set (econdtestas lass. pehan). 
next_level = FALSE; 
break; 


return (next_level); 
} /* end cond_1l_set */ 


TEST2menu(TESTZselect ) 


char X*TEST2select; 


{ 


puts(erase_ screen); 
puts("\t\t\tAM2904 CONDITIONAL TEST MENU\n\0"); 


puts(" 


puts 
piace Cu 


pues 
puts(" 
Pines (| 
puts(" 
puts(" 
puts(" 
puts¢ 
puts(" 
puts (| 
puts: 
puts. 
puts(" 
plncisnes 
pues 
pues” 
piles} 


gets(TEST2select); 


What condition 


do you want reflected by the 


Type a 


kh © 


YVRuUADNMmMIaAODrP OMDNOUL WN 


condition? \n we 


for (SIGN exor OVR) or ZEROVO oe 

for (SIGN exnor OVR) and not 
ZEROVO Se 

for (SIGN e€xor [Ove <0 oe 

for (SIGN ‘exnoreovVe) 

Bory ClO <0 1 

fOr notezE ROO. 

for OVR\0O"); 

form motlsOvn. ») 5 

for (CARRY wor wZEnOs 0) \r. 

for (not CARRY) or (mot ZERO) (Ose 

for -CARRY\ OU. 

for not CARRY 0 3. 

for (not CARRY vor =ZERO) \0 Je 

for *CCARRY 2orn Nee@eZene 0. Te 

for eslGN\0 3 E: 

for: not SiGn ae. 

for HELP with this menu\0"); 


to RETURN to a higher level\0"); 
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jy * procedure TEST2 


Soma 2 set(pchar> 
char (*pchar); 


x / 


/* This is the second level selection of the cond. test */ 


switch (*pchar) 


case ’0Q’: 
case ’1?’: 
case ’2’: 
case °3’: 
case °’4’: 
case ’5’: 
case ’6’: 
Gase  ~ 72: 
case ’8’: 
case °’9’: 
case °A’: 
case ’a’: 
case ’B’: 
case °’b’: 
ease °C’; 
case ’c’: 
ease, )": 
case °’d’: 


/ * 
/ * 
/ * 
/ * 
/ * 
/ * 
/ * 
/ * 
/ * 
/* 
/ * 


/* 
/ * 


SIGN 
SIGN 
SIGN 
SIGN 
ZERO 


Soi ovR or 2ZERO 47 

exniote  Ovh ana mot ZERO */ 
exor OVR-~ x/ 

exnor OVR */ 


* / 


not ZERO *x/ 

OVR */ 

not OVR */ 

CARRY or ZERO */ 

not GARRY or not ZERO */7 
GARRY ok? 


not CARRY */ 


MOmeCARRY (Or -2EHO 2k 


VASCARRY Or “net ZERO */ 


field _set(condtest_fld,4,pchar) ; 
if Senterouwond! 05804) ==" 07) 
bit_erase(I04_ 04); 


break; 

case ’E’: /* SIGN */ 

case ’e’: 

case ’F’: fA NOt eS LGN 7 

case.  { : 
fiele set (condtest tf ld.4.29char ); 
break; 

} 

i /* end procedure cond_2_ set ¥*/ 
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x os 
/ * AM2910 PROCESSING PROCEDURES co 
/ * */ 


J KK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


BRANCHaddress () 


{ 
char *branchselect, *CONTINUEcommand,cmd line[80], 


cont_line[10]; 
int helpset; 


branchselect = cmd_line; 
CONTINUEcommand = cont_line; 
helpset = true; 
while (helpset) 
{ 
helpset = false; 
BRANCHmenu(branchselect); 
switch(xbranchselect) 


{ 

case ’H’: 

case “h’: /*x help ns 
helpset = true; 
puts("The branch address field is 12 bits 

long, (ae 

puts("the max hex address is 3FF.\0"); 
puts("Enter anything to continue. \0"); 
gets (CONTINUEcommand) ; 
break; 

case ’R’: 

ease  r’: /* Return x / 
goback = true; 
break; 

default: 


printf("This is the address being 
used.%s\n" ,branchseléeécue 
CONTINUEcommand = branchselect; 
if( (*CONTINUEcommand<=’ 3’ &&*CONTINUEcommand>=’0Q’ ) 
&&(C*¥(++CONTINUEcommand)>=’0’&&*«CONTINUEcommand<=’7’ ) 
1. (XCONTINUEcommand>=’ A’ &&kKCONTINUEcommand<=’F’ ) 
': (XCONTINUEcommand>=’ a’&&*CONTINUEcommand< =’ f’ )) 
&&( (kK(++CONTINUEcommand)>=’0’ &&*CONTINUEcommand<=’7’ ) 
(+: CKCONTINUEcommand>=’ A’ &&kKCONTINUEcommand<=’ F’ } 
' + (KCONTINUEcommand>=’ a’ && *CONTINUEcommand<=’f’ ))) 
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i 
field set(msb_br_fld,0,branchselect); 
\ 


else 
x 
helpset = true; 
puts("Invalid input, the max hex number is 

ShE2NO 

puts("Press enter to continue\0"); 
gets(CONTINUEcommand) ; 
} 


break; 


} 
} /* while x / 
} /* procedure branch address select */ 


CONDITIONsequencer( ) 


{ 

char *CONTINUEcommand, *CONDITIONcommand,cmd_line[ 80], 
eont line( 10] ; 

int helpset,helpl,help2; 


CONDITIONcommand = cmd_line; 
CONTINUEcommand = cont_line; 


do 
{ 
helpset = false; 
CONDITIONmenu(CONDITIONcommand) ; 
switch(*CONDITIONcommand) 


{ 

case ’*h’: 

ease ~H’: 
helpset = true; 
puts("Help is coming Real Soon Now!\0"):; 
DULG. Press mente, to continue. \0"); 
gets (CONTINUEcommand) ; 
break; 

ease, rr’ : 

case ’R’: 
goback = true; 
break; 

case ’p’: 

case ’P’: /* FORCED PASS--unconditional */ 
field _ set(condtest_fld,1,CONDITIONcommand) : 
break; 

GaSe wt 
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case ‘FF’: /* FORGED FAI Lok, 
field set(condtest fidy27eonvillONconmanad s 


break; 
case ’t’: 
case ’T’: /* . TEST the condac tone 
do 
{ 


helpl = false: 
TESTimenu(CONDITIONcommand) ; 
Switch( *CONDITIONcommand) 


{ 

case ’r’: 

case ’R’: 
helpset = true; 
break; 

case ’h’: 

case °H’: 


helpl = true; 
puts("Here’s where help would be nice!\0"); 
puts( "Press enter to GContimie. 0... 
gets(CONTINUEcommand)  ; 
break; 

default: 
if(cond_1_ set(CONDITIONcommand) ) 


{ 
do 


{ 
help2 = false; 
TEST2menu(CONDITIONcommand) : 
switch( *CONDITIONcommand) 
{ 
case ’r 
case ’R’: 
helpset = true; 
break; 
case ’h’: 
case ’H’: 
help2 = true; 
puts("Help goes here!\0"); 
puts("Press enter to cont.\0"); 
gets(CONTINUEcommand); 
break; 
default: 
cond _ 2 set(CONDITIONcommand) ; 
break; 


} 


} 
while(help2); 
} 


break; 


} 


’ a 
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while(helpl); 
break; 
default: 
helpset = true; 
Puts GInvalid input, wait for menu.,0" ) ; 
sleep(l1); 
break; 
} 
} 
whilethelpset); 
} /* procedure CONDITION sequencer ¥*/ 


COMMANDselect( ) 


{ 
char CONTINUEcommand([4],*SEQUENCERcommand,comd line([ 80]; 


int helpset; 
SEQUENCERcommand = comd_line; 


do 


Ps 
xv 


helpset = false; 
SEQUENCERmenu(SEQUENCERcommand) ; 


switch(* SEQUENCERcommand ) 


7 

case ’r’: 

case ’R’: 
/* do nothing, keeps helpset = false */ 
break; 

case ‘h’: 

case °’H’: 


helpset =true; 

puts("Help is coming, Real Soon Now!\0"); 
buts Tress enter, to Continue: \0") ; 
gets(CONTINUEcommand) ; 

break; 


/* The sub_set parameter of the field set 
procedure is being used here to indicate 
four groupings of the choices for the 
sequencer field: 

1 means seq. field only is set. 

2 means branch address field 1s set. 
3 means conditional codes are set. 

4 means all three of above are set. 


“The above codes are put into the docu _word 
so that subsequent attempts to change the 
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seq. code can be done cleanly i.e. without 
leaving branch addr and cond codes from 
previous settings of the seq fld. The 
docu_word entry can be read and "decoded" 
to reset any appropriate fields. x7 


case ’Q’: 
case = 25% 
case ’8’: 
case ’9’:; 
case ’e’: 
case ’E’: 
field _set(seq fld,1l,SEQUENCERcommand) ; 
break; 
case ’c’: 
case ’C’: 
field _set(seq fld,2,SEQUENCERcommand) ; 
break; 
case ’6’: 
case ’a’: 
case ’A’: 
case ’d’: 
case ’D’: 
field _set(seq_fld,3,SEQUENCERcommandgd) ; 
break; 
case ’]’: 
case ’3’: 
case ’4’: 
casey 5 = 
case ’7’: 
case ’b’: 
case ’B’: 
case ’f’: 
case ’F’: 
field_set(seq fld,4,SEQUENCERcommand) ; 
break; 
default: 
helpset = true; 
puts ("Invalid 1nputaeeate )eseore nlc Ar somone 
r,R,h, HVOee 
puts("Press Enter to continue. \0'"); 
gets(CONTINUEcommand); 
break; 
} 


= 


il 


if( (*SEQUENCERcommand 


(XSEQUENCERcommand 
(*SEQUENCERcommand 
(XSEQUENCERcommand 
(*SEQUENCERcommand 
(*SEQUENCERcommand 


': (XSEQUENCERcommand 
| (*XSEQUENCERcommand 
| (XSEQUENCERcommand 
it €X*XSEQUENCERcommand 
| (XSEQUENCERcommand 
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aie itl 


mM 7 OO OI 


wa ~~ “a 


Nee ee Oe NY 


BRANCHaddress(}!; 


if(((*SEQUENCERcommand == ’1’)::(*SEQUENCERcommand == ’3’ 
(XSEQUENCERcommand == ’4’) ;: (*XSEQUENCERcommand == ’5’ 
Soh OURNCERcommand == °’6’ } | (*SEQUENCERcommand == ’7’ 
meohOUENCERcommand == ’A’) :;. (*SEQUENCERcommand == ’B’ ) 
(*SEQUENCERcommand == ’a’) :: (*SEQUENCERcommand == °b’) 
(XSEQUENCERcommand == ’D’) :.: (*SEQUENCERcommand == ’F’) 
(X¥SEQUENCERcommand == ’d’) |: (*SEQUENCERcommand == ’f’)) 

&& (!goback) 
CONDITIONsequencer(); 
if ((*SEQUENCERcommand == ’°4’) && (!goback) ) 
PUSHmenu(); 
else 
mie XSEQUENCERcommand == ’C’ {: xSEQUENCERcommand == ’c’} 
&& (!goback) ) 
CVCImenut ).; 
else 
mom *SEQUENCERcommand == ’°’8’)::(*SEQUENCERcommand == °B’)‘! 
meereuRENCERcommand == °d’) :;: (*SEQUENCERcommand == ’f’):‘: 
(XSEQUENCERcommand == ’D’) ‘: (*SEQUENCERcommand == ’F’)) 
&& (!goback) } 
NEEDPUSHmenu( ) ; 
else 
meet SEQUENCERcommand == °’7’)::(*xSEQUENCERcommand == ’9’)) 
&&  (!goback } 
NEEDLDCTmenu( ); 
if (goback) 
{ 
helpset = true; 
goback = false; 
} 
} 


while(helpset); 


} /* procedure COMMAND select */ 
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Program Name: Utils.c 
Purpose: Source code for the Utilities module. 


#include "extern.h” 
#include "declare.h” 
#include Cstd2 62h) 


bad_choice(choice) 
char *enoice, 
{ 
puts("bad choice called. 0 )- 
putchar(x*choice); 
sleep (1); 


docu (field,sub_ set, choice) 
int field,sub_set; 
char *choice: 


{ 

puts("docunew called\0"); 
/*This procedure sets the elements in an array called 
docu_word. Each element corresponds to a docu field (an 
int) which has a code in it indicating whether the docu 
field is being used. Unfortunately the docu fields don’t 
necessarily match the physical fields used by field set. 
This was necessary since each physical field doesn’t always 
stand alone. Ex. the three physical fields for the branch 
address are always set together. So docu has only one field 
for that function. So the size of the docu_word array will 
be changing as new modules are added. At the end, it can be 
adjusted to try for some matching of names or numbers or 
both. *7 


/* The code for each element is: 
a # means which sub_set function was selected. 
=I means this element is a selected docu field 
the values can be obtained from the 
micro word, 
0 means not set. ey 
switch({ field) 
{ 
case 
case 
case 
case 
case 
case 
case 
case 


m— NMR WHr 
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case l2: 
case 13: 
case 14: 
case 17: 
case 18: 
case 19: 
case 20: 
docu word (field—i1) = —1; 
break; 
case 8: /* The conditional testing function includes 
Hbysicdileritelds &,9,13,15. This will be 
covered by docu field #8 (case 8 in the 
docus procedure). Sub iset. wili hold an 
integer representing the function chosen. 
(i.e. forced pass, forced fail, conditional 
testing. } In going backwards, a table or 
big switch will be needed to translate. x / 


docu word(7]=sub sez; 
break; 

Gase 24: 
docu_word[field-1l] = sub_set; 
break; 

} /* end switch */ 

display_docu(); 

} /* end docu */ 


field set(field_cnt,sub_set,choice) 
mye, tield cnt,sub_set; 
char xchoice; 


/*There are 25 defined fields in the 29203 eval board 
microword, and several of them have multiple definitions. In 
this routine, we accept a pointer to the field and to the 
definition of the subset, and a pointer to a character which 
represents the actual choice. We generate a data structure 
which holds the choice and the actual bit pattern in the 
mreroword. *x/ 


{ 


ear scrap | 4]; 
ewatch( field cnt ) 


{ 

case 1: /x regsel fld, register address source x / 
octal field(0,choice); 
break; 


case 2: /* ien_fld, 29203 instruction enable */ 
binary fileld(C3e.cehor1ce) ; 
break; 
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case 3: /* oey_fld, 29203 cutpursenan lene. 
binary frelat4mchores). 
break; 


case 4: /* source _ fld, source field for the 29203. */ 
octal fielaG@oychorce) ; 
break; 


case 5: /* dest_fld, destination field. * / 
hex_field(8,choice) ; 
break; 


case 6: /* funectron. tidy Auneercn 1 eld: key 
hex field(12,choice); 
break; 


case 7: /* carryin_fld, carry-in mux control fern 
2904 a 
dual field( 16, choice. 
break; 


case 8: /* 1514 fld, bits 105 04, two MSB s” “47 
/* of conditional test codes. * / 
dual field(18, choice) ; 
break; : 


case 9:/* I3_10, bits I03_04 thru [00 04, four LSB S247 


/* of conditional test codes. * / 
hex field(20, choice, 
break; 
case 10: /* bits I05 04 thru 100 04 he 


/* don’t know how to use this field yet. */ 
break; 


case ll: /* ceu_fld, micro status enable bit * / 
binary _field(24,choice); 
break; 

case 12: /* cem_fld, macro status enable bit. * / 
binary _field(25,choice); 
break; 

case 13: /* cmden_fld, command enable field x / 
binary _field(26, choice); 
break; 

case 14: /* shiften_fld, shift enable field. xy 
binary field(27, enoice); 
break; 
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casiemi.o. 9 * comand f[ld, vecommand field. x 
Hexaetivetdi 23. choice). 


break; 

easemlo. /* Shorter bao snift field. * / 
hex field( 2&2cno1ce) 
break; 

ease 17: /* breakpt_fld, breakpoint field. toe 
binary Sfiteld (sz echonce ; 
break; 

case 18: /x notused _fld, this field not used. x / 
binary fveldi 33, choice), 
break; 


case 19:/*msb_br_fld,2 MSB’s of branch addressfield */ 
/*First test for conflicts by testing A 
Pprooctwoucd- ws tenomeontfitcts, finish setting*/ 
/*branch address fields with recursive callst*/ 


/*to field_set with cases 20 and 2l. K / 
if (docu_word[19]==0) 

{ 

if (docu_word[18]==0) 
{ 
docui tre ld rentyno Sub, choree ) ; 
dual field(34,choice); 
field_set(mid_br_fld,no_sub,++choice) ; 
Pika sset VSbroret Layne sub, choice }; 
} 

else 

if (docu word[l8] == =1) 
{ 


puts("Branch Address is already set. \0"); 
puts("Do you want to change it?\0"); 
gets(scrap}); 

Switch (x*scrap) 


case YES’: 
case ’yes’ 
case ’y’: 
case ’Y’: 


acewelg, nomsub.,cio1ece). 
dual field(34,choice) ; 
tied setumdeonmettasno sub,++choice) ; 
field set @rsbpoprer id, no sub,++choice) ; 
break; 
default: 


ont 


printf(’ ORAY--dt hasn ty oeen 


changed!\n"): 
break; 
} 
} 
else 
puts( "Garbage in the docu word fer #19, bee 
add.\0 3. 
} 
else 


puts("Can’t use this field for both register desig\0"); 
puts("nation AND branch address in the same micro-\0"); 
puts( "word. Right now it’s being used to select \0"); 
puts("register A and register B.\0"); 

} 


break; 


case 20: /* mid_br_fld, 4 middle bits of branch 
address field */ 


hex_field(36, choice) ; 
break; 


case 21: /* lsb_br_fld, 4 LSB’s of branch address 
field. */ 


hex field(40,choice) ; 
break; 


case 22: /* rega_fld, specify register A as source */ 
hex field(36,choice) ; 
break; 


case 23: /* regb_fld, specify register B as source */ 
hex _field(40, choice) ; 


break; 
case 24: /* seq fld, sequencer code x / 
/* This case has been modified to allow changing of 
the seq code after it has already been set. oe 
if Cdocu word), 2s ee =o, 


puts("The sequencer code is already set.\0”"); 
puts("Do you want to change it?\0"); 
gets(scrap); 

switch(*scrap) 


case ’YES’: 
case ’yes’: 
case ’Y’: 
case ’y’: 


ov 


switch(docu_word[ 23] ) 


{ 


ea-em-  *ecGlear previous branch address + 
string erase(34,43); 
docu word, 13] = 0; 
string erase(44, 47) ; 
docu_word[{23] = 0; 
break; 
case 4: /x* clear br.addr. and cond. test */ 
string erase(34, 43) ; 
docu_word[{18] =0; 
case 3: /* clear conditional test codes*/ 
Switch docu wordt.) 


{ 

case 4: 

case 3: 
string erase(18,23); 

case 2: 
Sthimemerase( 26, 31): 

case lL: 
bit_erase(Cmd_En); 
docu_word[7] = 0; 
break; 

} 


case 1: /* clear Sa vencer code */ 
string erase(44,47) 
docu_word[(23] = 0; 
break; 


docwu(tield vent, sib seuechoice )} 
hex field(44, choice); 
break: 
default: 
puts(. 1t hash tebeen changed. \0") ; 
break; 
} /* end switch */ 
} /*x end if */ 
else 


{ 


adoouifreld ent, suumoer senolce )- 
hex _ field(44, choice); 
} 


break; 


easewce. 7 Xk (Cond ptronamerescts, freld—-—-still not 
coordinated with shift codes. Check to see if conditional 


testing already set. If yes, erase previous micro word 
entries. If no, go on to set proper code. * / 
if (docu_word[{7]} != 0) 
{ 


3 


puts("We got to docu _word![7] not = 0.\0"): 
switch(docu_word[7] ) 

{ 

case 3: /* erase logical fields 8 & 9 */ 

case 4: 
string erase(18,23); 

case 2: /*k erase logical field 15, command _fld */ 
string erase(28,31); 

case l: /* erase logical field 13, Command_en_f1*/ 
bit _erase(Cmd_En); 
docu_ word] 7]@ =) 0: 
display _docu(); 
display_word(); 
display_in_hex(); 
break; 

default: 
puts("Garbage in sub _set of case 25 in 

field seta 0a 

break; 
} /* end switch */ 

} /* end if */ 


/* Set proper conditional testing bits. */ 
switch(sub_set) 
case l: /* Forced Pass */ 
qocu(3a,!.chorvee 
bit _set(Cmd_En); 
break; 
case 2: /* Forced Fail */ 
GOCcuCG, 2; cholee= 
bitcclear( Cmndgin). 


ASC LoCe—— oo 
field_set(command_fld,no_sub, scrap); 
break; 


case 3: /* Single level testing */ 
bit_clear(Cmd_En); 
kKscrap = ’9’; 
field _set(command fld,no_sub,scrap) ; 
docu(8,3,choice); 
¥Scrap <— “Gus. 
field _ set(I51I4_fld,no_sub,scrap) ; 
field _set(I3_I0_fld,no_sub,choice); 
break; 

case 4: /* Second Level Testing */ 
bit. clear( Cima ain). 
*Scrap =) oo | 
field _set(command_ fld,no_sub,scrap); 
docu(8,4, choice) ; 
field_set(I3_I0_fld,no_sub,choice) ; 
break; 
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aqerault: 
puts("Garbage in sub _ set for field _set case 


oc Or se 


Bie ana, 
} /* end switch */ 
} /* end switch */ 
} /* end field_set */ 


binary _field(bit_num, choice) 
mee bit num; 
char x*choice; 
mee xchoice == ’Q’) 
peeteelear( bit num) ; 


mse if (*choice == ’°]’) 
Dine Set( Dit num); 


else 
bad_choice(choice); 
} 
aoa t1ield{(bit _num,choice) 


moe) 6©D1t num; 
char *choice; 


{ 

eertch (*choice) 
{ 
case ’0Q’: 


biteclear( bit num): 
Dat clear( bit numtl) ; 
break; 


case ’]’: 
Diteec Ledr( bit num 
Bat set (bit _num+l]):; 
break; 


ease 72: 
bit _set(bit_num); 
bit_clear(bit_num+l); 
break; 


ease 3: 
Dee ect (bat num). 


a5 


bit set(bit_numt+l); 
break; 


default: 
bad choice lcupmec 
break; 


} 
} 


octal field( bit Jnumechorce, 


Ine) Duet mune 
char *choice; 


{ 
switch (*choice) 

{ 

case °Q’: 
bit_elear(bit_num), 
bit -clear(bitenun. |) 
bit -cleartbit lo num-Z. 
break; 

case ’]’: 
bitvelear (bit num 
bit .clear(bit numa 
bit set(bit num 2): 
break; 

cas en 7 2 
bit _¢lear( bit num); 
bitwset (bi Cenum ds) 
bit .clear( Da tamime 2s: 
break; 

case ’3°: 
bit_clear(bit_num) ; 
Dit sSeu( bltinun. 
bit. set (bit nun 
break; 

case °4’: 
bit_set(bit_num); 
bit _clear(baitpoumel ), 
bit_ clear (bitlmum: Zz), 
break; 

Case “572 
bit _set(bit_num) ; 
bit clear( bit guune |) 
bit_set(bit_num+2); 
break; 

case ’6’: 


bit set (bitenun 
bDityset (oa teaum 
bit clear( bi tenum= 2); 
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break: 

Gase 7: 
Poe sett bi tC num) ; 
bit_set(bit_numtl); 
Bate set( bitrnumt2 ) 
break; 

default: 
badmecnotece  (cnoice)., 
break; 


} 
} 


mere tield(bit num, choice) 


mat bit num; 
enar *choice; 


; 
L 
switch (*choice) 
{ 
case '0Q’: 
brepelear( bit num): 
bie elear( bit num!) ; 
bise  cleart bitlnum- Z ) ; 
Dietinc hear ( bat  niums 3); 
break; 


case °]’: 
bit_clear(bit_num); 
bat clear(Cbit_num+t) ; 
bre -chear( bat numtZ) ; 
bretTset( bitonumt 3); 
break; 


case °2°:; 
bit_clear(bit_num) ; 
bputeclear( bit num); 
bat set (bit num+2); 
Buteclear( bit numt+3); 
break; 


case ’3’: 
bueac lear (bit onum): 
bat clear( bit Jaume l): 
bit_set(bit_num+t2) ; 
bet aset (bat numro)- 
break; 


Gasca - 


bute clear (bit onun): 
betoset(bitonum+)); 


og 


bit clear(ortenum-2): 
bit clear (bi tenum.s ). 
break; 


Gase. 2 or 
bit clear(bit_num) ; 
bIitlset( bilan oo 
bit clean ba eenun 2) 
bit set (ba venum. oo): 
break; 


case ’6’: 
bit _clear(bit_num) ; 
bit. séu(bitenum. ie 
bit set bist enum. 2. 
bit clear bata num. 38. 
break; 


case tae 
bit. clear(bitcaum) ; 
bit sett bit _ num i): 
Dirt. -set( bitenums, 2). 
bit _set(bit_num+3) ; 
break; 


case ’8’: 
Dit Set (bit nun). 
bit elear( bit num 1): 
bit. clear (bat. num 2 )< 
bre clear (bit (num. 
break; 


case ’9’: 
bit set (bit. num) 
bit_clear(bit_numt+1); 
bigweclear(bitenum, 2 
bit. set(bit numts) ; 


break; 

3 af 

case ‘a’: 
case ’A’: 


bit _set(bit_num) ; 
bit_clear(bit_num+l) ; 
bit set( bit numa ); 
bit clear(Cbi vaaun- 3); 


break; 
ease bre 
case °’B’: 


bit set(b2tenum). 
bit -clear(pitanum-i) 


sis: 


Dist ecee bat onum? 2); 
bit _set(bit_num+3); 
break; 

Casecw Cc : 

case °C’: 
bit_set(bit_num) ; 
bittesSeUC DIC enuUmt 1). 
Bw eteat bit nun); 
biewelear( bit num 3); 
break; 


ease ° d’: 

case ’D’: 
bit_set(bit_num); 
baer Seti ba temums 
bat clear(bit snume2 ): 
Dhte Set Cbit numts)) - 
break; 

case ’e’: 

ease —’: 
bit _set(bit_num); 
bee Set (bate mum!) 
bit _set(bit_numt+t2) ; 
Doteeclear Dlt. num.) , 
break; 


ease °f’: 

case ’F’: 
buteset(b1¢onuMm ) ; 
Breeset (bit nvume 1). 
beteset(batvunum+ 2), 
bane set( bit “numt3); 
break; 


default: 
bad choice(choicée): 
break; 


display_word() 
{ 


= — CL — = re SCS ell 


inven. ) 3 
Denti” sa 
Horst sj)=0 3; j<47 2 j=3j716 ) 


ore) 


é 


for ( i=j 3 i ¢ 16+j 3 itt) 
putchar(micro_word{i]); 


putchar(’ 
putchar(’ 


} 
PUtTCHhar ean os 


} 


display_in_hex() 
{ 


yee 
ie 


Mie. . Meee 
DErtmati( 4 ae 
for -( $3=0°:95)\<4)3 i 
for. ( 129-7 1° olG ji ee 
hex _display( &micro_word[i]); 
print NS 
} 
putchar noe. 
} 
hex_display(pchar ) 
char *pchar; 
{ 
int i,value; 
value = Q; 
£ Or) el 0 ee et 
Switehe | *( pence)” 
{ 
case ~ 0: 
value = 2kvalue; 
break; 
case “Xe 
case ’]’: 
value = 1 + 2kvalue; 
break; 
case °?’: 
putehart 2): 
return; 
break; 
} 


pramt ? (9 4.x" vale 


} 


display _docu() 
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‘ 
ryt (1 3 
ent chai Vn): 
mow (1 =O, 1424; 1 ++ ) 
Mietinntir cd. .docusword) 1) ): 
memuchar(’ \n’ ); 


I 
beet set(i) 

i 1, 

{ 
Lite rror: 

enmror -= 0: 
Mic wOMWwOral 1) >. b. 

return(error); 

} 


fae clear (i) 
era! G in 
{ 
int error; 
error = QO; 


Mie wom wot-cdll 1) = 0. : 
return (error); 
} 
bit _erase(i) 
iL jolae ve: 
{ 
Mme nomword > ij e= 9 xX 
} 
string erase(i,)) 
Mera 2 dy.) 5 
{ 
moe <= js itt } 
MmrcLouword| 1) =) xo 
} 


or 


Program Name: Alumake 

Purpose: The Makefile used to compile the ALU module and 
its submodules. Tne name alumake must be changed to 
makefile to be used. 


test: ALU.o 203.menus.o 2904.supp.o alutils.o 
cc ALU.o 203.menus.o 2904.supp.o alutils.o -o test2 


Voi? 


Program Name: ALU.c 
Purpose: Source code for the ALU module. 


Peewethis is the draft of the 29203 section of the microcode 
generation system as of 27 Dec 1984. a 


#include <stdio.h> 
#include "declare.h”" 


char cmd line[80],*pcemd,micro_word[{49], *pmwd; 
int KEEPgoing, goback,docu_word[{ 24] ; 


main() 

{ 

emer contin[10]; 

mute, lim src,spe src,rt_shift,left_shift,rama,ramb,helpset; 


pemd = cmd_line; 
fe —-O0; 1<48;i++) micro_word[{i] = ’X’; 
Mee i-O0; 1i<24;1++) docu_word[i] = 0; 


goback = false; 


do 
{ 
KEEPgoing = true; 
helpset = false; 


rt_shift = false; 
left_shift = false; 
rama = false; 

ramb = false; 


am29203menu(pcmd); 
Switch (*pcmd) 


case ’h’: 
case ’H’: 
helpset = true; 
KEEPgoing = false; 
puts("The 29203 alu is documented in chapter 5 of the 


AMD\0O"): 
puts("data book. There are two types of functions it 
Can 0.) = 


puts("perform, regular functions and special 
mimet1ons. \O° ): 

puts("The rest of the decisions you must make are 
based on\0 7; 
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puts( ‘which of these you chose. oe 
puts("Press enter to continue.\0"); 
gets (contin); 


break; 
case ’r’: 
case ° RR’: 


puts("Do you really want to return to mastermenu?\0"); 
gets(contin); 
switch(*contin) 
{ 
case "*YES’; 
case ’yes’: 
case ’Y’: 
case ’y’: 
KEEPgoing = false; 
break; 
default: 
KEEPgoing = false; 
helpset = true; 
break; 


} 


break; 


case ’b’: 
case ’B’: 
do 
{ 
helpset = false; 
FUNCTIONmenu(pcmd) ; 
lim_sre = false; 
spc_sre = false; 
switch( *pcmd) 
{ 
case" oh: 
case ’H’: 
helpset = true; 
puts("The 29203 ALU functions are described on 
page 5-XKxX\0 9s 
puts("of the AMD data book. \0"); 
puts("Press enter to enter.\0"); 
gets (contin): 
break; 
case ’r’: 
case ’R’: 
KEEPgoing = false; 
break; 


164 


Casement seodessomana 7 require limits on the 
source field. */ 
Case 77": 
lamesre =. true; 
case ‘]’: 
case °2’: 
case — 3: 
case °4’: 
Case 4s 2 


pretda sec func. t lan 0 pend. 
docu func. fid., 0. pemd): 
carryin_menu(); 
gets(cmd_line); 

carry _set(cmd_line); 


break; 
case °0’: {/*F=high */ 
case ’8’: /*F=low x / 
/* codes 0 and 8 require limits on the source 
field. */ 
lies tC =e trie. 
case °9’: 
case ’A’: 
case ’a’: 
case °B’: 
case ’b’: 
case °C’: 
case ’c’: 
case ’D’: 
case ’°d’: 
case ’E’: 
case ’e’: 
case ’F’: 
case ’f?’: 


field set (funer? ld0,pemd) : 
doeu(iuncet ld, 0, pend )- 
break; 


default: 


i 


helpset true; 

puts inva la damp. Go): 
puts("Press enter to continue. \0"); 
gets (contin); 

break; 


J 
} /x end while */ 
while(helpset && KEEPgoing); 
ia Khe ReP going) 
{ 
helpset 


true: 


ne 


} 
brea 
case 


case 
do 


puts("These special functions are described on 


puts("5-XXX of the AMD data book.\0"); 


k | 
ts 
ey: 

{ 

spe sre = false; 

helpset = false; 

SPECIALmenu(pcmd) ; 

switch(*pcemd) 

{ 

case ’H’: 

case “h’: 
helpset = true; 
puts("Press enter to continue. 
gets(contin); 
break; 

case ’R’: 

case ’r’: 
KEEPgoing = false; 
break; 

case ’0Q’: 

case ’]1’: 

case ’2’: 

case ’3’:; 

case ’4’: 

case °5’: 

case °6’: 

case °7’: 

case ’8’: 

case ’9”’: 

case ’a’: 

case) A’ 

case ’b’: 

case ’B’: 

case ’c’: 

case ’C’: 

case ’d’: 

case ’D’: 

case ’e’: 

case ’E’: 

case ’f’: 

case ’F’: 
spc_sre = true; 


docu(dest_fld,0,pemd); 
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URS 


page\0";: 


field_set(dest_fld,0,pcmd); 


kpemd = °0Q’; 
fucka sset, tunes tla, 0. pemd ): 
break; 

case °M’: 

case ’m’: 
Spe sre = true; 
docidest  fild,0,pcmd): 
XDGMGe= ts 
field_set(dest_fld,0,pcemd) ; 
xpcemd = °8’; 
field _set(func_fld,0,pcmd) ; 
break; 

ease § 74 

case °z’: 
SDC. Seer) Werle. 
de@enucdest f1d,0, pemd) : 
xpemd = ’9’; 
field setidest fid,0,pemd); 
xpcemd = °8’; 
Pela sett tune: fid,O, pemed ) ; 
break; 

default: 


helpset = true; 
Pucs. Lilegal entry. \0: 3; 
puts("Press enter to continue.\0"); 
gets(contin); 
break; 
} 
} /* end while */ 
while(helpset && KEEPgoing) ; 
1i( !KEEPgoing) 
{ 
helpset = true; 


} 


break; 


default: 
helpset = true; 
KEEPgoing = false; 
pute ©’ Pidegalentry..0):* 
puts("Press enter to continue. \0"); 
gets( contin); 
break; 

} /* end main switch */ 


Tiweltin sree = trile kk spe sre '= true 
&& (KEEPgoing) ) 


{ 


Oy, 


helpset = true; 
while(helpset) 
{ 
helpset = false; 
SrTestant. SOURCEmenu(cmd_line) ; 
switch (*cmd_line) 
{ 


u 


case ’R’: 

case ’r’: 
KEEPgoing = false; 
break; 

case ’H’: 

case ’h’: 


helpset = true; 
puts ("Sources for ALU operations are 
described\@ 
puts ("on page 5-XXX of the AMD data book. 
\ Ore 
puts ("Type a € to continue ©): 
gets (contin); 
break; 


Casewenu 
ramb = true; 

case ’l’: 

case ’2’: 
rama = true; 
field _set(sre f1d,0,cmd7ilrme © 
docu( sre-fid,0. cmd Vinee 
break; 

case ’4’: 
ramb = true; 

case ’5’: 

case ’6’: 
field .sét(srest id, 0,ecndsiane. 
docu(sre Pid, 0) cide ines: 
break; 

default: 
helpset = true; 
puts("Illegal entry, type a C to repeat.\0"); 
gets(contin); 
break; 


} 
} /* end while */ 
if ('KEEPgoing) helpset = true; 
} 


else if (lim_sre == true && (KEEPgoing) ) 
{ 


helpse t= senue, 


168 


while(helpset) 
{ 
helpset = false; 
Sreolestare ss s0URCE Imenu(emd line): 
Switch (*cmd_line) 


Case eH = 
ease ih = 


helpset = true; 
puts("Because of the use of the I0 bit to 
indicate\0" ): 
puts("special functions, there are limits to 


ter a: 

puts("sources for ALU operands. These limits 
are\0"); 

puts("described on page 5-XXX of the AMD data 
eon so 


Pputst type a C te,-continue.\0" ): 
gets(contin); 
break; 


case ’R?’: 
case fr: 
KEEPgoing = false; 


break; 


case 220s 
rama = true; 

case ’6’: 
field_set(src_fld,0O,cmd_line); 
Goeul( sre tld.0; cmdline); 
break; 


default: 
helpset = true; 
puts( Livegalemury, type a C to repeat. \0"): 
gets(contin); 
break; 


} 
} /k end While */ 


if('KEEPgoing) helpset = true; 
} 


else if (KEEPgoing) 
{ 


Secc estar t. SOURCE2menu(cmd_ line); 
switch(*cemd_line) 


ease 7H’: 
Case i 
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puts("The special functions requiem ia: 


r0=0\0 
puts("Therefore the sources are limited to 

the\ 0 ees 
puts("set on this menu. The sources are 


described\0"); 
puts("on page 5-XXX of the AMD data 
book. V0 an 
puts ("type a C.to comtumuc, O77. 
get sSieon tines 
break; 


ease nn = 
Gacecumn | 


break; 


case °0’: 
ramb = true; 
case ’]’: 
rama = true; 
field_set(srcec_fld,0,cmd_line); 
docu(sre_fld,0,cmd_line); 
break; 
case ’4’: 
ramb = true; 
case °5’: 
field _set(srce_fld,0,cmd_line); 
docu(src.iid,0jcrdviane). 
break; 
default: 
puts("Illegal entry, type a C to repeat.\0"); 
gets(contin); 


break; 
} 
} 
if (spce_sre != true && (KEEPgoing) ) 
{ 


helpset = true; 
while(helpset) 
{ 
helpset = false; 
dest_start: DESTINATIONmenu(cmd_line); 
switch(*cmd_line) 


case ’H’: 
case ’h’: 


helpset = true; 
puts("This menu describes the destinations 
for\0 oe 


Cas c 
case 


Case 
Cas € 
Gasec 
Cas € 
Case 


Case 
case 
case 
case 
case 
Case 
case 
case 


Case 
Case 
case 
cas¢ 
case 
case 
case 
Cas ¢ 
case 


Case 
case 
case 
case 


puts("the ALU result. They are documented 
One 02 Jc 
Pato pacemo- Ant Of the AMD data 
Doom. 0 =. 
Diese ty pemcmes to comermue. \0 >) ; 
gets(contin); 
break; 


Re 
i als 
KEEPgoing = 


false; 


break; 


= (i? = 

er 

Cee 

7: 

ono ee 
Gt Siig t true; 
field set(dest_fld,0,cmd_line); 
docu(dest fld,0,cmd_line); 


break; 


7>RB?: 

79’: 

"as 

he 

ies 

Beas 

a 

-DUT: 
beft shift true; 
field_set(dest_fld,0,cmd_line); 
docu(dest_fld,0,cmd_line); 


~_ 
— 


break; 


Ae 
*6’: 
ass 
ey oe ane 
Ce 
ea 

Eee 

af: 

ae 
field_set(dest_fld,0,cmd_line); 
docu(dest_fld,0,cmd_line); 


break; 


>M?: 
’ v5 
e 


m 
eae 
r5°-; 

kcmd 


gitime==— 0. : 
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field set(dest_ flay ena line = 
docut{dest_fid, 0, cmndwiime)- 
/* Need to add things here!!!¥*/’ 
break; | 
default: 
helpset = true; 
puts( "Illegal entry, type o.c te 
repeat.\0"); 
gets Gecontin) ; 
break; 
} 
} /* end while ¥*/ 
if('KEEPgoing) helpset = true; 
; 


if (rt_shift == true && (KEEPgoing) ) 


shift2 menu(); 

gets(cmd_line) ; 

if (shift_set(cmd_line)) goto dest _start; 
bit clear (Zi. 

} 


if (left_shift == true && (KEEPgoing) ) 


: 

shift3_menu(); 

gets(cmd_line); 

if (shift_set(cmd_line)) goto dest start; 

bit _clear(27); /* the shift enable for the 2904. */ 
} 


J 
if (KEEPgoing) 


{ 

ENABLEmenu(cmd_line,contin); 

if (*cmd_line == ’Y’ ‘: xemd_line == ’y’) 
kcmd line = ’0Q’; 

else 

kcmd_line = ’1’; 


field_set(ien_fld,0O,cmd_line); 


if (*¢contin == ~Y” :. *e€entin —-— 93 
Comte nee se Oe 
else 
KCOnta nN. -seeee 
field set (oey 7 fla .0 contin 
} 
if (rama == true :: ramb == true && (KEEPgoing) ) 
{ 


REGISTERmenu(cmd_line); 
field set(reg_src,0,cmd_line); 
docutCreg srce,0 > cmd ane. 


be2 


: 


if (rama = 


{ 


true && 


Seen som ns ) } 


RAMAmenu(cmd_ line); 


switch (kcemd_line) 


} 


{ 


case 
case 


case 
case 


case 
case 
case 
case 
case 
case 
Case 
case 
cas e¢€ 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 


if { ran. = 


1 


7H’: 
ye =: 


puts("This menu describes the register 


selections for\0",; 


puts("the ALU. They are documented on\0"); 
puts("page 5-XXX of the AMD data book.\0"); 
DUTGe type aneCrto continue. \0): 

Sets conti hi). 

break; 


ee 
rps 


break; 


2 Oe 
oie 2 
Me) es 
Qs 
pelea: 
yee 
*6’: 
Daehn 
> R?: 
(Qe 
- a? : 
pies 
ee 
a? ae 
Co 
Cele 
ede 
Paty mes 
eee 
ee hicee 
Dep es 
cies 


field_set(rega_fld,0,cmd_line) ; 
docucrega ct kd 0 omd sline) : 
break; 


true && 


(KEEPgoing) ) 


dS 


RAMBmenu(cmd_line); 
switch (*cmd_line) 


1 
case °H’: 
case ’h’: 
puts("This menu describes the register 
selections for\0"): 
puts (”’ the sALur They are documented on\0"); 
puts('page 5-XXxX of the AMD data Bock. Ul oe 
puts("type a C to contimme, (0) 
gets(contin); 
break; 
case ’R’: 
case ’r’: 
break; 
case ’0Q’: 
case ~1e= 
case ’°2’: 
case ’3’: 
case °4’: 
case ’°5”’: 
case °6’: 
case. 7. 
case ’8’: 
case ’9”’: 
case ’a’: 
case 7A’: 
case °b’: 
case ’B’: 
case ’c’: 
case ’C’: 
case ’d’: 
case ’D’: 
case ’e’: 
case ’E’:; 
case ’f’: 
case ’F’; 
field set (regbetid, 0-cmd2 line. 
docu( resp ftldj;0,emd lime = 
break; 
} 
} 
} 
while(helpset :: KEEPgoing); 
ex?1rvas 


} /* the end of 29203master */ 
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Program Name: Alutils.c 
Purpose: Source code for Utilities module which is compiled 
with the ALU module. 


#include <stdio.h> 
#include "declare. h" 
#include rexterneah” 


docu(field,sub_set,choice) 


moe field,sub_set; 
char *choice; 


{ 
mares ( docu called\0") ; 
sleep(2); 


bad_choice(choice) 


char *choice; 
{ 
mmes( bad choice called.\0”"); 
matchar(*choice) ; 
sleep (2); 
} 


field_set(field_cnt,sub_set,choice) 


era t preld-ent,sub sev; 
char x*choice; 


[xX There are 13 defined fields in the 29203 eval board 
microword, and several of them have multiple definitions. 
[imieenhis routine, we accept a pointer to the field and to the 
definition of the subset, and a pointer to a character which 
represents the actual choice. We generate a data structure 
marenh holds the choice and the actual bit pattern in the 
microword. *x / 


switch (field_cnt) 
{ 
case l: /* regsel fld, register address source */ 
eseral field(0;choice); 
decu(1,0,choice) ; 
break; 


ED 


case 2: /* ien fld, 29203 instruct tonmenab lo. 
binary fiehaeeehiorce 
docu( 2,0, chores | 
break; 


case 3: /* oey_fld, 29203 output enable */ 
binary _field(4,choice); 
docu(3,0,choice); 
break; 


case 4: /* source _ fld, source field for the 2970 75 
octal field(5,choice) ; 
docu(4,0,choice); 
break; 


case 5: /* dest _fld, destination field. */ 
hex field(8,choice); 
docu(5,0,choice); 
break; 


case 6: -/* function _fid, -funct ton” facta x / 
hex field(12,choice) ; 
docu(6,0,choice); 
break; 


case 7: /* carryin_fld, carry-in mux control ifor@ane 
2904 K / 
dual field(16,choice) ; 
docu(7,0,choice) ; 
break; 


case 8:/*I5I4 fld, bits I05_04 and 104 04, two MSB’s*/ 
/* of conditional test codes. * / 
dua lGiielrat le, chovce). 
docu(8,0,choice); 
break; 


case 9:/*I3_I10, bits 103 _04 thru 100 _04, four LSD soa 
/* of conditional test codes. 7 
hex field(20, choice) ; 
docu (90, choice): 
break; 


case 10: /* bits 105704 thrusloor ey 
/* don’t know how to use this field yet */ 
docu( 10. 0 schomee) = 
break; 


case ll: /* ceu_fld, micro status enable bit */ 


binary_field(24,choice) ; 
docu(11,0,choice); 
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break; 


case 12: /* cem_fld, macro status enable bit */ 
binary. fretbd{25, choice); 
aocwolL2, 0 choiee 

break; 


case 13: /* cmden_fld, command enable field */ 
baary of held’ 265 choice } ; 
Gocw 13, 0,enhoice )* 
break; 


case 14: /* shiften_fld, shift enable field */ 
binary of tekd( 27, choice) ; 
qoceu [4 U-enoice je 
break; 


case 15: /x* command fld, command field */ 
mex. t1eld(28,choice) ; 
deen)! >. 04 choice): 
break; 


case 16: /* shift _fld, shift field */ 
hex field(28, choice); 
aoc 6, 0,choi ce); 
break; 


case 17: ye breakptotila, breakpoint bit */ 
banaryotield(3s2,cncoice) ; 
qocu( 17,0, ¢ehoice )-: 
break; 


case 18: /* notused_fld, this field is not used */ 
binary. t1eld@se5 choice): 
aqoeul 16,0, choice); 
break; 


case 19: /* msb_br_fld, 2 MSB’s of branch address 
field * 
dival tield(3¢choice) ; 
qoeu( 19,0, choice); 
break; 


case 20: /* mid_br_fld, 4 middle bits of branch 
address field * 
hex _ field(36,choice); 
moeul( 20 .0),choice)= 
break; 


case Zl: /* Ilsb_br_fld, 4 LSB’s of branch address 
field */ 


ey 


hex _field(40, choice) ; 
docu( 21, 0 4enouce = 
break; 


Case. 122. /* rega_fld, specify register A as source ¥*/ 


hex field({( 3b, ehomece - 
docu( 22,0, chopee i, 
break; 


case 23: /x regb_fld, specify register B as source */ 


hex_field(40, choice) ; 
docu( Zo 70, enoree).: 
break; 


case 24: /* seq_fld, sequencer code */ 
hex _field(44, choice); 
docu( 24.0, chomec |: 
break; 


binary 1 redid Gilt anum, enor ce) 


int: Dien: 
char xchoice; 


if (Xehorce: === 0 


4 


bitJvchbeari( ba tum): 


else if (*choice == ’]’) 
bit [set (bit enum)- 


else 
bad_choice(choice) ; 
} 


dual_field(bit_num, choice) 


it, Daee eau. 
char *choice; 


{ 

switch (*choice) 
{ 
Case 405 


bit _clear(bit_num); 
bit_clear(bit_num+l); 
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break; 


ease ©: 
bit_clear(bit_num) ; 
biewset( bit num) )- 
break; 


ease ~ 2": 
bit_set(bit_num) ; 
biteclear( bit num! ); 
break; 


case ’3’: 
pitteset (bit enum) ; 
Bese t bast mum |) 
break; 


getraul t : 
bad_choice(choice) ; 
break; 


} 
} 


Memal field(bit_num, choice) 


meme bit num; 
char *choice; 


{ 
switch (*choice) 
{ 
case ~ 0": 
batecilear( bit num) ; 
bit_clear(bit_num+l); 
baitenc lear ( bat num): 
break; 
ease. 1): 
bit_clear(bit_num); 
beetenc Lear (bit num 1); 
bit_set(bit_num+2); 
break; 
case °2’:; 
bit_clear(bit_num) ; 
butemset (but num) - 
busta lear (bit numt2Z). 
break; 
Sasemy 3.2 


biteclear( bit num); 
Bbaeeeese t (Dt mum Sa ie 
Disease t (bit numt2o. 
break; 


le?-9 


case °4’: 
bit setUpi tana. 
bit clear (bDitenum7 ). 
bit ¢lear(bitenumn=- 2) 
break; 

case ’5’: 
bit. set(bitoaumaes 
bit. clear bi tenun. 
bit set(bi1t strum. . 
break; 

case ’6’: 
bit_set(bit_num); 
blitlsetr (bi tonun.]!) | 
bit cleart@pl tenun.2., 
break; 

case °7’: 
bit_set(bit_num) ; 
bit _set(bit_num+l); 
bit Set bitocnumt? 
break; 

default: 
bad_choice(choice) ; 
break; 

} 

} 


hex field(bit_num,choice) 


int bale ein, 
char *choice; 


switch (*choice) 

{ 

case ’0Q’: 
bit _ clear( bit num) 
bit_clear(bit_num+l); 
Dit veleartbit num 2): 
bit - clear(b1t num 3. ; 
break; 


case °]’: 
bit _clear(bit_num); 
Bitveléear( bit numel) 
bit clear(bitonum.2) 
bit set(bit. numts)- 
break; 


ease. 2a. 


bit. clean bleenune] 
DIlt clear (pitenum . . 
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bit_set(bit_num+2) ; 
Ditto ean Dy mums 
break ; 


case ’3’: 
bDubeec lear (bre Saum )-; 
pajeecc learCbattenum-+ |) 
Digeeset( bit num): 
bit_set(bit_num+3); 
break; 


case ’4’; 
brveclear( bit num); 
bitweset(bitenum | ) ; 
Dit clear(bit numt+2Z); 
basbmelear( bat num+3)) 

break; 


case.’ 5’: 
bite clear( bit num) ; 
bateset (bit _numtl); 
bit_clear(bit_num+2) ; 
bmteset( bit num+3); 
break; 


case ’6’; 
brtsclear (bit num); 
Dboceeset (bit num | )-; 
beta set{ bat numt+2Z): 
Dre. clecar( bit numt+3): 
break; 


case °7’: 
Dew clear (bit num): 
bit_set(bit_num+l1) ; 
biG Set( bit numt2Z) - 
bat oset (bit num+3)> 
break; 


ease °~ 8": 
buteset (bit num) 
bueclear( bitanum+t!) )- 
bit_clear(bit_num+2); 
Datteee lear (bit num+ soe 
break; 


case ’9’: 
bit _set(bit_num); 
prteclear(bitonum |) 
DitEeL ear Di bemums 2). 
Diteset (bit) num? 


es 


break; 


case. A 

case ‘a’: 
bit _set(bit_num) ; 
bit clear (bil vanunaie = 
bit _set(bit num 
bit_clear(bit_num+3) ; 
break; 


case ’°B’: 

case ’b’: 
bit_set(bit_num) ; 
bit_clear(bitlnune)):; 
bit set(6it num-Z, . 
bit set( bit pumas, 
break; 


case °C’: 

case ’c’: 
bit _set(bit_num); 
bit_set(bit_numtl); 
bit_clear(bit_num+2) ; 
bit_clear(bit num. | 
break; 


case ’D’: 

casey id’: 
bit_set(bit_num) ; 
bit set(bitenum.) | 
bit clear (bat enum: 2; 
bit set (bat numss ); 
break; 


case ’E’: 

case ’e’: 
bit _set(bit_num) ; 
bit TSet( Dice nun 
bit set (ba t_num=cy). 
bitrclear( bit num+s). 
break; 


case °F’: 

case ’f’: 
bit _set(bit_num) ; 
bateset (ba t snumal). 
Ditsset (bat enun2 
bit set( bit num so 
break; 


default: 


arg 


DaGgmenonree( cho1ce jj 
break; 


display_word() 
{ 


int as 
peaintt (" COs 
moe) JO) <a ye 8 -7F1LG ) 
{ 
fom 2 =7 ee CG jp ert) 
puechan«nirero word | 1 |); 
Dlleeiaie 9 Je: 
pubeharc 4:9) 


plcechar( \n’ ): 
} 


display_in_hex() 
iat 1, 3% 
Eeint ft (” ioe 
forme © j)-0: j<473j=j+16) 
hone (1= jl) <P os l= oe 
hex _display( &micro_word[i]); 
Die denies (2 eke 
BWechar{ > \n’ ); 


hex display(pchar) 
ehar *pchar; 


ite  1,Vvalue; 
value = 0: 


omen —O- 2 « 4255 g++) 


Switch (*(pchar+i) ) 


Cas en Ol 
value = 2x*value; 
break; 


ease ~“X": 
case ’]’: 
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valwe = |] +° 2*vae ier 


break; 
Case 72 
DPUutenarl( 7? i: 
re wuen, 
break; 
} 
} 
PriImti ( 24x) va lwe. 
} 
Dit seta) 
eee Lk: 
{ 
Int. “error: 
error = Q; 
switch (micro_word[i]) 
{ 
case ’X’: /* Don’t care, therefore set it! */ 
Meron word) 1.9 sal. 
break; 
case ‘1’: /* Already set, therefore OK few 
break; 
case ’0’: /* Cleared, therefore an error. x / 
Micro Word 1 ee— 9. 7. 
error = 1; 
break; 
case ’?’: /* Already in?the serrorestaucr KA 
break; 
default: /* Garbage in the microword! *xX/ 
puts ("Garbage in the 
microword!!!!\nyvO7 ge 
sleep(2):; 
break; 
} 
return». (erron)- 
} 


bit. clear (i) 
ieee 
{ 


int error; 
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error = 0: 
Su tch (micro word|1))> 


f 
t 


Casco 7 elon weare., therefore clear it! */ 


Meemo.word{i|] = ’Q’; 
break; 
case ’Q’: /* Already clear, therefore OK. */ 
break; 
case ’]’: /x* set, therefore an error. Ky 
Miero Word! 1) = °?7? 
Sit Or ae 
break; 
case ’?’: /x Already in the error state. K / 
break; 
default: /* Garbage in the microword! */ 
puts ("Garbage in the 
Merowora’ !.) Yn v0”) ; 
sleep(2); 
break; 
} 
BReturm Gerror ) ; 
} 
bit _erase(i) 
int i: 
{ 
Mrero word ii) "eax = 
} 


ESO 


Program Name: 203.menus.c 
Purpose: Source code for the menus used in the ALU module. 


#define erase screen "\O33 b23 7Oee0n On 
tinclude <stdio.h> 


J KKK KK KK KOK KKK KK KKK KOK KKK OK KOK KKK KOK KKK OK KKK KOK KKK OK KOK KK KK KK KK KKK / 


7% * / 
Te AM29203 MENU PROCEDURES * / 
/* +7 


J KKK KKK KK KK KK KOK KK KOK KK KKK KOK KKK KKK KK KKK KK KK KKK KKK KKK KK KK KK KK / 
am29203menu(amZ29203select) 
char *am29203select; 


{ 
puts(erase_ screen); 
puts("\t\t\tMASTER AMZ29203 ALU MENU nn Gee 
display _word(); 
display_in_hex(); 
puts("The X s indicate bits which are not yet defined\0"): 
puts("The defaults for the AM29203 ALU are:\0"}); 
puts("\tRegister Address Select - bits 47-45 - A,B 

pipeline = 111\0' 7%: 

puts("\tiInstruction Enable =~ bit 44 = Disable) _—a) Oe 
puts("\tOutput Enable - bit 43 - Disable = 1\0"); 
puts("\tSource — BPirtey42-40)- DAG — hee 0 oe 
puts("\tDestination — Bits 39-36 =) YoU swale oe 
puts("\tALU Function -— bits 35-32 90ORee eee Oe 
puts("What do you want to do next?\0"); 
puts("\ttype a B to choose ALU FUNCTIONS\O"); 
puts("\t\tS “to choose SPECIAL FUNCTION. 0 3 
puts("\t\tH for HELP with this program.0 7- 
puts("\t\tR to RETURN Voemnwener steve! 3. 
gets(amZ92Z03select); 

} /*xk procedure am29203menu */ 


FUNCTIONmenu( FUNCTIONSelect ) 


char *FUNCTIONSelect; 


{ 
puts(erase_screen); 
puts("\t\tAMZ9203 ALU BASIC FUNCTION SOE LEC? «0 oe 
puts("Enter the value corresponding to the function you 
wish to perform\0"); 
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mats(” \t\tO F = High\0"); 

ees | ot eel ee woe Rk eee Carry in\0" } ; 
ees Sb ee = heen oe eee Carry In\0"); 
mimes \tvts “Re+ S + Carry In\0"); 

mmes( \t\t4 SS + Carry In\0"); 

feeesc« \t\t>S (NOT S) + Carry In\0"); 
ce st \t\tG R + Carry In\0"); 

Pees \t\t?y F = (NOT R) + Carry In\0"); 
pares (' \t\t& F = Low\0"); 

mes (” \t\t9 -F = (NOT R) AND S\O"); 
mers (’ \t\tA F = R EXCLUSIVE OR S\0"); 
Memes« \t\tB F = R EXCLUSIVE OR S\0"); 
mmts(' \t\tC F = R AND S\0"); 

muts(” \t\tD F = R NOR S\O0"); 

maes( '\t\tE F = R NAND S\0"); 

Boes("\t\tF F = R OR S\0"); 


mmes('’ \t\tH for HELP with this program\0"}; 
puts("\t\tR to RETURN to higher level\0"); 
gets(FUNCTIONselect); 

} /* procedure FUNCTIONSelect */ 


SPECIALmenu(SPECIALselect ) 


{ 


puts(erase_ screen) ; 

mimes ( \t\ytAMZ9203 ALU SPECIAL FUNCTION MENU\n\0"); 

puts("Enter the value corresponding to the function you wish 
tompertormn yo ): 


puts (" QO Unsigned multiply\0O”"); 

puts(" [I SeBeD to Binary conversion \c  ): 

puts (" VOeMilt iprecic lone pC tomb inary Conversion \0" ) ; 

puts(" 2 Two’s Complement Multiply\0"); 

mits (" 3 Decrement by 1 or 2\0"): 

puts (" I increment by isor 2\0")- 

puts(" > Sign/Magnitude to Two’s Complement 
Comversion\0 ); 

pucs (" 6 Two's Complement eMultiply\0"); 

mits ( " 1 BCD Dividewpy 92.0 9)" 

puts(" 8 Single Length Mormalize\0"); 

Puts (" o> (Binary “te BCU SConvers ion, 0" )- 

puts(" ZZ Mualtiprecisasonmo many eto BCD Conversion\0" ; ; 

puts (" A Double Length Normalize; First Division\0"); 

puts(" B VEBCD AddNOe)- 

puts(" C Two’s Complement Divide\0"); 

mutts { " i SBeU Subtracueee es —sh)- S — | + Carry In 

BOLO) 
Bues( E Two’s Complement Divide Correction and 


Remainder\0Q"); 


PUES F BCD Subtract  F = "See ee are en 


BCD\ 0 3= 
puts(” H for HELP with this menue 9. 
puts{” R to RETURN to higher level\0"); 
gets(SPECIALselect): 
} /* procedure SPECIALselect */ 
SOURCEmenu(SOURCESelect ) 
char *SOURCEsSelect; 
{ 
puts(erase_screen) ; 
puts("\t\t\taAMZ9203 ALU SOURCE MENU a1) 
puts("The source control default is DAQ\n\0"); 
purs i Operand R Operand §S Mnemonic\0"}; 
puts("Enter a OO RAMA RAMB RAMAB\O"); 
puts(" l1 RAMA Direct B RAMADE VO ae 
puts(" 2 RAMA Q Register RAMAQ\0"); 
puts(" 4 Direct A RAMB DARAMB\0O" ); 
puts GC! 5 Direct A DirectB DADB\O"}; 
puts( 6 Pirect sn Q Register DAQ\O ae 
puts(" il Instruction Register.0 | 
Pucss © P Pipeline Register\0"); 
puts(” H for H with this proe@ran.0 7. 
puts(" R to RETURN to higher level\0"); 


gets(SOURCESelect); 
} /* procedure SOURCEmenu */ 


SOURCE]lmenu(SOURCEIlselect) 
char *SOURCElselect; 


puts(erase_screen); 

puts("\t\tE\ tCAMZ9SZO0S VALU SOURCES MENU ne ae 

puts("You have chosen one of the following AM29203 ALU 
functions: YOuge 


putcsi("\tE. = Hah Ose 

puts(’ \tF = Ro VvCarryve ton. 

puts(’ Veter + CNOT FR) +eCarry im e 

puts Vth =< LOW en. 082 

puts("For these functions, the only allowed AM29203 ALU 
Sources are: \n\0"); 

puts("\tOperand R Operand SS Mnemonic\n\0"); 

puts("\tRAMA Q Register RAMAQ\0") ; 

puts("\tDirect A Q Register DAGhin oO ): 
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} 


emies, Type a 2 for RAMAG\O ); 

Pees(' \t6 for DAQ\O0"); 

Pees’ \tH for HELP with this program\0"); 
mmes( \tR to RETURN to a higher level\0”); 
gets(SOURCEIlselect); 

/* procedure SOURCEImenu */ 


SOURCE2menu(SOURCE2select) 


char *SOURCE2select; 


£ 
4 


puts(erase_ screen); 
fumes Vt\t\tAM29203 ALU SOURCE SELECT\n\0"):; 


puts(” You have chosen an AM29203 ALU Special 
EUneGt1on yn. 0) 
puts(" What sources do you want to use\n\0"); 
puts(" Operand R Operand §S Mnemonic\0"); 
puts(" Enter a OO RAMA A RAM B RAMAB\0O"): 
puts(" 1 RAM A DTRECT Es RAMADB\O" ); 
puts(" 4 DIRECT A RAM A DARAMB\0O"); 
puts(" a Dike le DIRECT 2B DAE G0 * 
puts (" H - for she Le gat thne thas menu, 0" >) ; 
puts(" R to RETURN to a higher level\0"):; 
gets(SOURCE2select); 


/* procedure SOURCE2menu */ 


DESTINATIONmenu(DESTINATIONSelect) 


char *DESTINATIONSelect; 


{ 


puts(erase_ screen); 
mtes{ \t\t\tAM29203 ALU DESTINATION MENU\n\0"); 


puts(" Enter the value corresponding to the 
destination you desire\0Q"); 
Dut s (" Oe RhAMDAY-— of ~tommavee Ari Ehmeure sown Shift \0"); 
puts ( " l1 RAMDL - F to RAM, Logical Down Shift\0"); 
puts (” 2 RAMQDA - Double Precision Arithmetic Down 
Shiite 0s ae, 
puts (" 3 RAMQDL - Double Precision Logical Down 
Sit tO) oe 
puts(” + RAM = F GoenAaview: €iheparity\0'); 
puts(" S QD = F tomieviowm sniit ©\0''): 
puts(” by LOADG >=" EPevomOn wrth parity \0"): 
puts (" fi RAMO™= Fe pomreawiwien parity\0"); 


ESQ 


Puc. s) a 
Pues 
puts ( 


PUES | 


Due Sas 
puts 
puts. 
Bit sie. 
Huts ( 
puts(" 
puLS | 
Dalle 


gets(DESTINATIONSelect); 


me OO © 


a) SS et Se 


RAMUP As 
RAMU EP as 
RAMQUPA - 


F to RAM: 
Esto RAM, 


Arithmetic Up Shit wa 
Logical. Up Share «ae. 


Double Precision Arithmetic Up 


Shift\0 


RAMOQUPL = Double Procisitonmeoote a ue 


RAMEE XT o= 


HG ae ayes 


Pheer. 


Main Memory\0"): 
for HELP with this procrmam.0. 9), 
to RETURN to higher level\0"); 


} /* procedure DESTINATIONmenu */ 


REGISTERmenu(REGISTERselect) 


char *REGISTERselect; 


{ 


puts(erase_ screen); 
puts("\t\t\tAM29203 ALU REGISTER ADDRESS MENU\n\0"); 
The default source selection is Source A - 


Dubs 
puts |” 


puts C 


Source B 


pipeline, 


Shift \Os ae 


EF to Yvionly 0 

Up: SHiftft.e w.>:. 
SIGNEXT =—-S POO (to..Y (is) oe 

Sign extendmrsce 0 3. 
Instruction Register 0 je 


pipeline, \0 @; 


Destination C - 


pipeline\n\0"): 


Enter the value corresponding to the register 


nuts (you desire \0 4: 


Suts 
puts(" 
puts 
puts | 
puts(” 
Pus e 
Puts 
puts(" 
Piles Gs 


NSO BPWNMF © 


S 


ource A 
Pipeline 
[instruction 
Pipeline 
Instruct ion 
Pipeline 
Instruct ion 
Pipeline 
Instruct ton 


gets(REGISTERsSelect); 
} /* procedure REGISTER menu */ 


Source B 


Pipeline 
Pipeline 
[Instruct ton 
Instruction 
Pipeline 
Pipeline 
Instruction 
Instruction 


DIRECTmenu(constantl,constant2) 


char *constantl,*constant2; 


{ 


puts (erase_screen); 


0 


address\0"); 


Destination C\0"); 
Pipeline\O”") ; 
Pipeline\0"); 
Pipeline\0O"): 
Pipeline\0"); 
Instruction\0 om 
Instruction\Uas 
Instruction. oe 
Instruction\0O oe 


} 


mest \t.t\ tAM29203 ALU DIRECT SOURCE MENU\n\0"): 
mpits{( “You have chosen an ALU Tunction, source, or 
destination which,0":: 


puts (" requires a constant or Ra and Rb to be 
entered into the\0"): 
puts(” the branch address field of the 
Ireroins tructionvn\O0 ) : 
puts(” This constant or the RAM register 


designations is 1\0")}; 
mimes(” byte in length\0°'); 


puts(" Please enter the constant or the RAM register 
designation\QO":;: 

puts (" Ente mecallie St Omen h iP oviGiethis programy 0 ): 

Bucs (” Enter a R to RETURN to a higher level\0"): 


pemes (constant! ,constant2Z) ; 
/* procedure DIRECT menu */ 


ENABLEmenu(INSTRUCTIONSelect,OUTPUTselect ) 


meat *£INSTRUCTIONselect, tOUTPUTselect; 


{ 


puts(erase_ screen); 
puts("\t\tAM29203 ALU INSTRUCTION AND OUTPUT ENABLE 


MENU\n\0" 5; 
Bucs (" Do you want the ALU results to appear on the 
Ve Dee Oa 
puts(" ivioe Janes yy elon ©1bS 0 oe 
puts(" Type a NewstoreNO\n navn ) 
gets(OUTPUTselect); 
puts (" Do you want to change the contents of any ALU 
register\0"); 
puts (" during “this ALU operation?’ \n\0" ) ; 
mats (" Type.any @ ‘form YES\O); 
puts (" Type an, Ni for NO\0 >; 


gets(INSTRUCTIONSelect); 
/* procedure ENABLEmenu */ 


RAMAmenu(RAMASelect) 


char *RAMASelect; 


{ 


puts(erase_screen) ; 

puts(”\t\tAM29203 ALU RAM A REGISTER SELECT\n\0"); 

pues (” \t Enter the value corresponding to the RAM A 
Register \0"); 

putcs( \tyou wish to select\n\0"): 


Pil 


puts Wh 
puts wae 
pits (soar 
Puts Glue 
DUS Ve 
puts Vt 
puts G \t 
pikes wt 
Dilts (> we 
puts("\t 
puts("\t 
puts \t 
putcs( \e 
puts ( “At 
puts (- VC 
puts (> Vt 
puts \t 
puts("\t 
gets(RAMAselect); 


YmRmAaAmoavrmr oo oOopwnr oO 


RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 
RAMA 


Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 


ee DP OP PP 


OO? ap: 
Oe 
ZO a 
SCE 
4\0"); 
Sao) 
Gor): 
Her ys 
SO 
3\ Oaae 
AO); 
Bo) 
CX0E) : 
Die) 
E\0"); 
EY Ore 


for HELP with this menu\0"); 


to RETURN to a higher level\0"); 


} /* procedure RAMAmenu */ 


RAMBmenu(RAMBselect ) 


char *RAMBselect; 


{ 


puts(erase_screen) ; 


puts("\t\t\tAMZ9203 ALU RAM B REGIS PERV SELEC] 3) Ue 
Bios ab Enter the value corresponding to the RAM B 
Register \0"); 


puts("\tyou wish to select\n\0"); 


Dities (ct O RAM B Register 0\0"); 

puts Vt 1 RAM B Register 1\0"); 
puts("\t 2 RAM B Register 2\0"); 
puts("\t 3 RAM B Register 3\0"); 
puts("\t 4 RAM B Register 4\0"); 
puts("\t 5 RAM B Register 5\0"); 

puts Ce 6 RAM B Register 6\0"); 
puts("\t 7 RAM B Register 7\0"); 

putce ot 8 RAM B Register 8\0"); 

Piles at 9 RAM B Register 9\0"); 
puts("\t A RAM B Register A\0"); 
puts("\t B RAM B Register B\0"); 

puts( \t C RAM CGC {Register ©y0 3 
puts("\t D RAM B Register D\0"); 

pute Nat E RAM B Register E\0"); 

pits i) et F RAM B Register F\0"); 

Pit sca ee H for HELP with this menu\0"); 
puts("\t R to RETURN to a higher level\0"); 


2 





2ts(RAMBselect) ; 
* procedure RAMBmenu */ 


ois 


Program Name: 2904.supp.c 
Purpose: Source code for the utilities used with the Alu module. 


/ * This version of the 2904 code is included to allow 
the testing of other modules. The utilities have been 
removed, as has the main program portion. ts July fSSeae XU 


/ * This program will aid the 2900 system designer in the 


programming of a 2904 "glue" chip. * / 
i * This version is not as current as the utilities used 
with the Sequencer module. 27 Dec. 1984 ty, 


/* This source is set up to work with the vt1l100 from 
VAX/unlx. ao) 


#include ‘<stdio.h> 

#define erase_screen "\O033([2J\033([0;0H" /* vtl100 Sra 
screen and home cursor *Xy/ 

#define TRUE 1 

+define FALSE 0 


/* These defines relate to the 29203ET board, 
should be contained in a routine to initialize then, 


than as defines. */ 


#define Pe 0d 16 
#define Lieo4 live 
#define 110 _ 04 8 

#define 109 04 Ze 
#define 108 04 29 
#define I07 04 30 
#define 106_04 pt 
#define 105_04 18 
#define 104 _ 04 IDS, 
#define 103 _04 20 
#define 102.04 21 
#define 101 04 ee 
#define 100_04 23 
#define Ceu_04 24 
#define CeM_04 Zo 
#define Se_ 04 at 
#define Cmd_En 26 
#define Cmd_ 3 28 
#define Cima 72 Zo 
#define eee 30 
#define Cmd_0 Soll 
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/* Variable Declarations */ 


extern 


/ * 


enar 


Bach 
that 


we display or save a microword, 


char cmd line{80!,*pcemd,micro_word[49],xpmwd; 


We need a static data structure which holds the 
different choices available for bits I5 to I0 of the 


2904. */ 


*¥choices O04(n) /* return a pointer to the n-th choicet;/ 


int ns; 
Beatie char *choice {|} = { 
MUMOxxN | /*X Carry in = UW carry, first choice =-0 */ 
MO KX’. /* Carry in = U Carry, second choice -l1 */ 
ee a /Xecarry inemiecarry, third choice -—2 */ 
wx | /*k vearry in @Macro carry, first choice -3*/ 
Mien 5 /X “carry in = Macro carry, second choice -4*/ 
Mpecer. |. /* scarry in =e Macro carry, third choice =-5 *x/ 
muOOLEX”, /* Sioad u register; retain overflow bit -6 x, 
meoenoux ~ /* Load UW regsinvert carry, first choice -—?T*/ 
weeebogx . /* Load u reg;invert carry,second choice -8*° 
Pex. OPOX", /* Load wu reg, immed., first choice. -9 */ 
"X1lOXXXK", /* Load u reg, immed., second choice. -10 */ 
eetx , /* Load ures, immed., third choice. -ll *, 
Perk ixx , /* Load u reg, immed.y fourth choice. -l2 */ 
BieCUKKK’ , /*eload u reg, immed., fifth choice. -13 */ 
erwin, /Xenoad u rege=mammed., sixth choice. -14 *k, 
Meyers , /* Load u reg, immed., seventh choice. -15 */ 
meOoox . /kelkoad M regeminvert carry -16 */ 
Pox Xlix’, /* Load M reg, immed, first choice -17 ¥*/ 
"XX1X1X", /* Load M reg, immed, second choice -18 */ 
weceutx , /teboad M regweimmed, third choice -19 */ 
ORIOXKX”, /*%e Load M reg, immed, fourth choice -20 */ 
mmCOXXX” 7k Load M res. immed, fifth choice -21] */ 
le 

return (choice [n]); 
} 


/* Now we need a structure to manipulate this data. 
time we Invoke aAghUmMetLlOn with a Choice, a pointer to 
choice gets added to the list of such pointers. When 
we will search this list to 


find an entry which matches all of the chosen functions. ey 
dummy ( ) 

{ 

puts ("Dummy called\n\n\0"); 

} 
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shift2 menu( ) 
{ 
puts(erase_screen); 
puts("You have chosen a down Shift for wthis Mvcrononer 
There are\0”); 
coded 0 thru in 
bits I[S\0"98 
Choose the shift pattern you desire from 


puts("16 possible shift patterns, 


DuUtSsS{ thro ko. 


the\ 0732 
puts(’ following set: \0' |; 
puts.” VtzZenon -— 0 -> RAMn, O. =? One 
puts("\t one = i} -> RAMn, L => Cn 
puts C" \tetwoue= 0 => RAM RAMO -> Mc, Mn => 
On\0 ee 
puts("\tthree = i —-> RAMn, RAMO —> On V0" 3. 
puts( \tfourm —= Mc -> RAMn, RAMO —> Gn 0) 2 
puts("\tfive = Mn —@*RAMnG RAMO <=> "On Or oe 
puts("\t six = 0 -> RAMn; RAMO. —> On 0) oe 
puts("\tseven = 0 -> RAMn, RAMO -> Qn, OC. 
Mc\0" 
puts("\teight = RAMO -> RAMn, Q0 -> On, RAMORS 
Mc\ 0 ie 
puts("\tnine = Mc —-> RAMn, OCs > Sone RAMO -. 
Mc\ 0 oe 
puts("\t A = RAMO -> RAMn, G0 -> @Gnvo0 oe 
DIbts (= sts = Ic =-> RAMn, RAMO -> Qn\O"): 
puts ( \ tae = Mc —-> RAMn, RAMO -> Qn, Q0 -> 
Mc\0) ae 
puts 2c Peep = Q0 -> RAMn, RAMO -> Qn, 00 De 
Mc\ 0" Fe 
puts ( \t we = In exor [IOvr -> RAMn, RAMO -> On v0 ve 
puts("\t F = Q0 —-> RAMn, RAMO -> Gn\0'"2 


puts("\t H to get help with this procedure\0"); 
puts("\t N to back up one frame.\0"); 
} 


shift3_menu() 
{ 
puts(erase_screen); 
puts("You have chosen an up shift for this microword. 
There are\0O”): 
coded 0 thru F in 
bits I19\07 3 


puts("16 possible shift patterns, 


puts("thru I6. Choose the shift pattern you desire from 
the\0 se 

puts ( following seta. 

puts("\tzero = 0 —-> RAMO, 0 Geo O0. RAMn -> 
Mc\0 35 

puts("\t one = il —-> RAMO, 1 -> QO, RAMn -> 
MeO 
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Duets, tt two 0 -> RAMO, Oy ee eto Ue 0 


ee 
pd 

| 
VY 


puts("\tthree RAMO, Ti OOO a 
DUtsi .ttour > = Cine = EVA”, Oe oe ae) i, eg) ae. 
Moe.0" } s 
Duts("\tfive = Qn —-> RAMO, le — OO" RAM -—> 
MeO "= 
pmest Vt Six = On Pee > SRAMO. Ome > SOOO tc: 
puts("\tseven = Qn -> RAMO, i OO ~O 
puts(”"\teight = RAMn -> RAMO, ia CU sositAn =~ 
Mey 0: 
puts("\tnine = Me) ler Abo; nine 2 Ol RAMn -> 
Nieon.0 1: 
puts ( NE A = RAMn -> RAMO, Cine -OO.0 
puts{ \t 8B = Mec => PRAMO’, Oy) O00 Die 
DButs( \t € = On => RAMO, Mc -> G0, RAMn ->D 
Me cOme ts 
parts("\t dD = Qn —-> RAMO, RAMn -> @0, RAMn —- 
MeO 
pmuts("\t £E = Qn  -> RAMO, Meme O00 3. 
puts \t F = Qn -> RAMO, Ravine» @O\0 ); 


Bitesi yt H to get help with this procedure\0"): 
puts("\t N to back up one frame.\0"); 
} 


carryin_menu() 


puts(erase_ screen); 
puts("\tThe Carry into the least significant stage of 
Dime waLU\ 0 
Pest ts controlled by bits I12 and Ill, and sometimes 
bases ~ Oa. 
puts("1I5, 13, 12, and Il. There are seven possible 
enorces 0"); 
puts("\tType a zero to select ZERO as the carry 
Serie Oy) 
puts("\tType a one to select ONE as the carry-in.\0":: 
Puts \tlype a two to select Cx, the Z output of the 
oes Oe 0. 
puts("\tType a three to select the carry bit from the 
Memo —rec.O }- 
puts("\tType a four to select the micro carry bit 
complemented\0") ; 
puts("\tType a five to select the MACRO carry bit\0"}; 
puts("\tType a six to select the MACRO carry bit 
complemented’ 0”): 
puts("\tType an H for help.\0"); 
} 


statusl menu() 


{ 


puts(erase_screen) ; 


oe 


DiWlts «to Mis 


puts("registers which may be selected. 


puts("choices to be made, 


puts("of the 
puts("\tType 


puts("\tType 
puts("\tType 


puts("\tType 
} 


status2 menu() 


{ 


[0 through 15 control the two 1d? 1.enue ms: 
status\0 oe 
There are three 
main (Gla 
and you can change either or 
both\07 am 
registers: \n\0"); 


a ’0’ to make no changes to the status 
registers\0"); 
a ’1’ to change the micro status 
register. \0 oe 
a ’°’2° to change the MACRO status 
register, \0 oe 
a ’D*® to exit from this section, \@ oe 


puts(erase_screen); 
puts("\tYou have chosen to modify the micro status 


puts("(abbreviated uSR). 


puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 
puts("\tType 


puts("\tType 


register \0O")}; 
There are 15 different 
choices; wae 
zero to load the MSR into the uSR.\0"); 
one to set all bits in the Ushi] 
two to swap the MSR and the uSR\0O"); 
three to reset all bits to 0 in the 
uSR\O 3 
four to load the uSR from the immed. 
inputs VO ve 
a five to load all uSR from I except 
overflow\0 oe 
invert carey 


oo 


m9 


a six to load all use from Lf, 


bit 0 3 
a seven to reset only the zero flag in the 
uSR\ 0 2 
an eight to set only the zero flag in the 
uSR\0") ; 
a nine to reset only the carry flag in the 
uSh\0 2 
an A to set only the carry flag in the 
uSR\0 7s 
a B to reset only the sign flag in the 
uSRkR\0O" 
a C to set only the sign flag in the 
uSR\O 
a D to reset only the overflow flag in the 
uSR\0 3s 
an E to set only the overflow flag in the 
uSkR\O 


an H toeget herp. oe 
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2 


agreement 


mic stat _set(pchar) 
/*k This routine sets up the microstatus register, 
with the status2_ menu. 


ehnar *pchar;: 


{ 


ewitch (*pchar) 


case 


case 


case 


case 


zoe = 


bite hear 
bit clear 
Dist hear 
bit clear 
bit _clear 
bit clear 
break; 


pe eae 
bit_clear 
bit_clear 
bit_clear 
bite lear 
bie clear 


/* set the microstatus register. 


in 
* / 


Ve uloadetmemmrcrostatus from the MACRO 


status */ 
CTLOS 204): 
(104 04); 
CTOs 204] 
LOZ. 04) ; 
CLOd 04). 
(100 04); 


* / 
(10 sm04) 
(104 04); 
L033 04) : 
ComOmeg0. 45): 
CLOT 0d). 


bit seb C100 704. 


break; 


19>, 
a) * 


bit clear 
Dit clear 
bit clear 
bite Wear 


/* Swap the micro and MACRO status 


WOoGdSs. */ 
(I105_ 04); 
(104 04); 
Os 04 
(L004); 


bit set (101_04); 


bit clear 
break; 


Begs 
bide de ans 
bit_clear 
Ditiscl ear 
Blue lec 


/* zero the microstatus register. 


(100 04); 


k / 
CPOSm0a 
(104 04); 
(103204) - 
(102 04); 


bit set (101 04); 
bit _set (100 04); 


break; 


case °4’: /* Load the microstatus register from 


the I pins. Many possible inputs here, need an auxillary 


mata structure. */ 


noo 


case 


Case 


Cas 


case 


Cas ©€ 


bit set e105 204s 
bit_set (104 04); 
bit set 103804). 
bit _set (102 04); 
bit ‘setr 10s 04s 
bit _set (100_04); 
break; 


°5’: /* Load from 1, with overtlow retarneeee 
bit clear {10Ssg04. 

bit clear (1042.04). 

bit clear (1032027 

bit set (lL02Z007 7. 

bit _set (101 04); 

break; 


*6B’: /x Load from 1, wWitiwecarty invert Need 
to turn on [5 cor [14 or boar ay 

bit _set (103_04); 

bit_clear (102 04); 

bit_clear (101 _04); 

break; 


"7’: /k Reset the zero flag. *x/ 
bit _clear (I05 04); 

bit _clear (104 _ 04); 

bit sete 103204). 

bit clear (102 04); 

bit clear (101 04); 

bit_clear (I100_04) ; 

break; 


78’: /x Set the zero flag. */ 
bit.clear (105_704)- 

bit _clear (104 04); 

bit_set (103 _04); 

bit.cleare clo eod 

bit_clear (101 04); 

bit _set (100 04); 

break; 


79’: /x Reset the carry flag. */ 
bitclear (105304); 

bit clear (104 04); 

bit_set (103 _04); 

bit _clear (102 04); 

bit _set (101 _ 04); 

bit clear (100 04); 

break; 
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case ’a’: 
GaSe. 9A * Sete the carry flag: */ 

Ditmc Lear +(105.04,); 

bit, clear 2 104 04); 

biteset (103004). 

bit clear (I02 04); 

bit_set (I101_04); 

bit set (100704 )5 

break; 


case ’b’: 
case ’B’: /x Reset the sign bit. */ 
Distec hear (105-204 7; 
bit _clear (I04_04); 
bit set (103 04); 
bit_set (102 04); 
Diteec lear. (101. 04) ; 
bit_clear (100 04); 
break; 


case “Cc: 
case °C’: /x* Set the sign bit. */ 
buteclear (i057 04): 
bit _clear (104 04); 
bit_set (103_04); 
bit _set (102 04); 
Dit ve weary ¢ 10M Oe): 
Dita sete (100204. 
break; 


case °’d’: 
case ’D’: /* Reset the overflow bit. */ 
bait oc lear sl 05204)) ; 
bit _clear (104 04); 
bit set..(103.04 
bit_set (I02 04); 
bitlsset (101204), 
bit_clear (I00_04) ; 
break; 
case ’e’: 
case ’E’: /x Set the overflow bit. */ 
bit-eclearv 105204): 
bit _clear (104 04); 
bit set Glos e0doe 
bit-oset 072304. 
bit_set (101 _04); 
bit set “(1O0m04 
break; 


default: 


} 


status3_menu() 


{ 


puts (” 


break; 


puts(erase_ screen); 
puts("\tYou have chosen to modify the MACRO status 


puts("(abbreviated MSR). 


puts("enable bits, 
puts("There are 8 different choices in this menu:\0"); 
puts("\tType a zero to load the Y inputs into the 


puts("\tType a 
puts("\tType a 
puts("\tType a 


puts("\tType a 
puts("\tType 
puts("\tType a 


puts("\tType a 


} 


© 


macro _stat_set(pchar) 


No help implemented yet. 
sleep (2); 


WOO ee 


register, a 
The MSR is also controlled bv 
five\0"); 


which are set on the next menu.\0":; 


MSR\O"); 


one to set all bits (if enabled)\0”"); 
two to swap the MSR and the uSR\0O"); 
three to reset all bits (if 


enabled)\0O"); 


four to swap the Mc and the Movr\0"); 
five to complement, alee oirts ve 
six’ to load alll MSR geueme 


Invert 
carry\0 


seven to load all MSR from I\0"': 


/* This routine deals with the loading of the 


char *pchar; 


switch (*pchar) 


Case 
Case 


a Oe 
bit _clear 
bit _clear 
Dit .c lear 
bit_clear 
bit clear 
bit clear 
break; 


a. 
bit_clear 
bit clear 
bit clear 
batt lear 
bit clear 


/* Load Y inputs into the MSR 


/* Set all bits in the MSR 


Macro Status register. xX/ 


K / 
(105 2045). 
(104 04); 
(103204 ):; 
(POzs04)). 
(101 04); 
(I100_ 04); 


*/ 
Clana 
(104.04); 
COS O48) 
(102 04); 
(101-04) ; 
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cas € 


case 


ca>c 


case 


Cas 


@on t care. */ 


case 





bit set (1007040. 
break; 


eee /* Swap the MSR and the uSR */ 
birt selear CIi0S204) ; 

bit_clear (104 04); 

brteclear *Olds 304): 

bagtenc lear “102 204) ); 

bit_set (101 _04); 

bitJclear C100 .04) ; 

break; 


oe {/* Reset all bits in the MSR */ 
bit l_celear (105_04) ; 

bit_clear (104 _ 04); 

brie wean « 103..04)). 

bit_clear (102 04); 

bit-<set “601.049, 

bit_set (100 04); 

break; 


7A’: /k Swap the Mc and the Movr */ 
bit clear (10 5c0m))- 

bit clear (104 _ 04); 
birt.clear.Cl03_04)- 

bre. set. (LOZ 104 7 

Disve-c learn «(101 0408 

bitesclear (200704); 

break; 


i et Complement. atil, bits an the MSR */ 
biteetear (10504) ; 

bit_clear (104 04); 

biteelear -(LOsgom) 

biteset “<(hUZ aO0ws: 

bit Clear (107) 04>. 

bit_set (100_04); 

break; 


tiles? 7% HOAaGgGmweherMsSk, Wlth the carry 


inverted. Several choices here, need to implement the 
decision process. Turneon l04 ors 10S. 09 or both: I00 is a 


bitiset: Chogm0a:. 
bitoctears( 102 047); 
bit clear Wold 04 0e 
break; 


i ey teLoagmene MSR trom the I inputs. 


/* Many choices here. ko 
bit sete a 04 ic 


2.0.3 


bit _set (104 04); 
biteset (lG3et4 = 
bit_set (I02 04); 
bit_set (101.04); 
bit set (lO00Q204). 
break; 


} 


/* The status4 menu is not used with the eval board, since 
/* the individual status enables are not in the microword. */ 
status4 menu() 

{ 
puts(erase_ screen); 
puts("\tThere are six enable inputs to the status 
registers\0"): 
puts("on the 2904. They are a master enable for the 
uSR,\0"); 
puts("a master enable for the MSR, and individual 
enable for\0"); 
puts("the four bits of the MSR (Zerojercarry, 1s Bou 
overflow).\OG se 
puts("You must chose which of these enables to 
activate. \Ura@ 
puts("\tType a zero to activate the micro status 
register 0 9 
puts("\tType a one to activate the MACRO status 
register\CG a 
puts("\tType a two to activate the zero flag in the 


MSR\OC a 
puts("\tType a three to activate the carry flag in the 
MSR\C oe 

puts("\tType a four to activate the sign flag in the 
MSR\C 

puts("\tType a five to activate the overflow flag in 
the MSR\O"?;: 


puts("\tType a six if you want the rest of the flags 
disabled\0"); 

puts ("\tType an Ho ferene wn. 0. 

: 


J 


status5_menu() 


4 
\ 


puts(erase screen); 
puts("\tYou can output something from the 2904 
onto\C se 

puts("the Y-bus. What do you want on the bus?\0"); 

puts("\tType a zero to output the micro-status 
register\0"); 

puts("\tType a one to output the macro-status 
register\0”"); 
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mats i wtlVvVpew a. two tCosourput the immediate inputs 
from: 0 

puts = \t\ tthe ALU\O = 

puts( \tlyoe @ three tor no output\0); 


status6_ menu() 
{ 
puts(erase_ screen) ; 
mvcs( \tWhat condition do you want reflected by the 
GoOnadmwuion 0 1. 
puts("code output?\0"); 
puts( \tType a zero for (SIGN eéxor OVR) or ZERO\O"); 
puts("\tType a one for (SIGN exnor OVR) and not 
ZOO, =) 
EWO LOretolGN eGxor OVER) \O0"); 
three for (SIGN exnor OVR\0O"); 
four efor es Zeno. 0). 
fivewrorenot .Z Eno. or 
puts("\tType Si GhomeOvrn 07) + 
puts("\tType seven for not OVR\O0"); 
puts("\tType an eight for (CARRY or ZERO)\0"): 
Pes vt lype a mine for (mot CARRY) or (not ZERO)\0* 
puts("\tType an A for CARRY\O"); 
Bucs ( \tType a B for not CARRY\0"); 
ets tlype a C tor (net mARRY Of ZERO)\0"); 
puts( <tType a D for (CARRY or not ZERO)\0"); 
Besa. tiype an E for <SIGNYO ); 
mies( \tlype an F for not) SIGN\O )-; 


} 


puts("\tType 
Bucs ( \tType 
puts( \VtType 
puts("\tType 


v,ononA wD 


pend 2 set(pchar) 
/* This is the second level selection of the cond. 
test */ 
ear (*pchar) ; 
{ 


Switch (*pchar) 


ease ~0": /* SIGN exor OVR or ZERO *x/ 

bitv-clear@os704): 

bit clear @u0Zeo.). 

bit _clear(I01_ 04); 

bit _clear(I00_ 04); 

if (micro_word{105_ 04] == ’0Q’) 

bit_erase(I04 04); 
break; 


case ’1’: /* SIGN exnor OVR and not ZERO ¥*/ 
bat clear( 10cm04 ) ; 
bit _clear(I02 04); 
ba tec lean GlOumsO 4D 


Z05 


case 


case 


Case 


case 


case 


case 


bit _ set: 100 04): 

if (microt_word) 1052024 
bit _erase(I04 04); 

break; 


iO) 


ae ge /* SIGN exor OVR~ */ 

bit _clear(I03_ 04); 

bit_clear(I02_ 04); 

bit_set(I01 04); 

bit@elear( 100 04): 

if (micre Word! 105m04) lie 
bit_erase(I04_ 04); 

break; 


Y oak /* SIGN exnor OVR *x*/ 

bit clear( 103004); 

bit_clear(I02_ 04); 

bit _set(I0l_04); 

bit set (moO vas. 

if (micro_word[I05_04] == ’0’) 
bit _erase(I04_04); 

break; 


epee /* ZERO 7 
bit_clear(I03_ 04); 
bit. set( 1023704); 
bit_ciear (10 Laas. 
bit_clear(I00_04); 
if (micro_word[I05_04)] 
bit _erase(I04 04); 
break; 


Tt 
Ht 


VO 


Or. V¥ not ZERO xk 

bit_clear(1I03_04); 

bit set(I02 04); 

bit clear lO... 

bit_set(I00_ 04); 

if (micro_word[I05_04] 
bit _erase(I04_ 04); 

break; 


20) 


me /* OVR X/ 

bit oclear( 10 sme... 

bit _set(I02_ 04); 

bit set(lole0d 

bit_clear(I00_04); 

if (moucrorvordiyl0awd4) 
bit _erase(I04_ 04) ; 

break; 


ql 
i 


0 


77>. /k not OVR */ 
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case 


Cas © 


case 
case 


Case 
cCasec 


Case 
cas € 


Bttecilear( ig3loa 

buteset (1027045. 

bit set ( i101, 049. 

bit_set(I00_04); 

Mee mtcrolword (ean 04] == 70” ) 
bit _erase(I04 04); 

break; 


mis f*® CARRY 2OreZERO *7 
bit_set(I03_04); 

Bue clear( 102 04). 
bit_clear(I01_04): 
bit_clear(I00 04); 


ion ther Oo word PUD O44) ==. 04 } 
bit_erase(I04 04); 

break; 

Pee VALCO eP CARY wots n@t ZERO “x / 


bitsset( 103 04); 
bDigeclear( 102.0455 
bit _clear(I0O1l 04); 
bit _set(I00 04); 


tim microuvond  hUomO4)s==5 O° ) 
bit_erase(I04_ 04); 

break; 

a? 

PA 7 KX oCARRY 47 


bievset( 1037004 

birt cleartllog 04} 

bit set (10l)_04); 

bit_clear(I00_04); 

Die Cire Oomwion dito On m= =m 0) 
bit_erase(I04_ 04); 

break; 


ey? 

oe es /* NOCACARRY “*/ 
bit_set(1I03_04); 

bit -cleart i102 20c3)- 
bit _set(I0l 04); 
bitwsiet (100 04); 


Poem cCrouvOtaimnOmm 4 | == |) 
bit_erase(1I04 _ 04); 

break; 

Gree: 


Cae JA NOEMOCARRY oF ZERO. */ 
biteset ( 103007 
bit_set( 102 04); 

birt velear( 101204). 


bit _clear(I00 04); 


if (micro word) fO0s004 |= 
bit _erase(I04 04); 
break; 
case ’d’: 
case ’D’: /* CARRY or NOt ZERO 


bit. sev@i10s 04): 
bit _set(I02 04); 
bit. clear 10 iG 
bit_set(I00_04); 


if (micro word|/105 104 |) =—) 
bit _erase(I04_ 04) ; 
break; 
case ’e’: 
case ’E’: /* SIGN */ 


bit -set( 103 0a 
bit _set(I02_04); 
bit_set(I01_ 04); 
bit_clear(I00 04); 
break; 


Cases “te = 

case ’F’: /* not SIGN */ 
bit set Clisn04).. 
bit_set(I02_ 04); 
bit _set(I01l_04); 
bit _set(I00_ 04); 
break; 


default: 
puts("No help yet.\n\0"); 
sleep (2); 
break; 


} 


status7 menu() 
{ 
puts(erase_ screen); 
puts("\tThere are two steps to selecting a test 
Goudit ion; The\0 ve 
puts("first is to select a register to be used, and the 
second \0"); 
puts("is to select a test on that register. This menu 
selects \0":; 
puts("the register, or two special tests which combine 
two\0 = 
puts("registers.\n\0"); 
puts("\tType a zero for the micro status register\0"); 
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Dic sieett !voemawone Hlonuwmmen MACHO status register\0")}; 

puts("\tType two for the Immediate status inputs:0”;: 

DUELS  \tlype a three for Immediate SIGN exor Macro 
SlGN yO 3: 

DUES Vb lypemanrtour for Imm. SIGN exnor MACRO SIGN*0” 

} 


at) 


cond _1 set(pchar) 
/* This is the first level cond. code select, and 


matches status/ menu. * / 
enar *pchar. 
int next_level; 
next level = TRUE; 
switch (*pchar) 
{ 
Gasew 0 Guy“ hieroe status register Selected. ¥/7 


bat clear( 10504); 

bre set ( 104 04): 
/* Note that I04 can be cleared for many cases, see Tbl. 4, 
Beeeo- 1/9 */ 

break; 


Gase “lec. /* Macro status register. */ 
bit _set(I05_ 04); 
bit _clear(I04 04); 
break; 


ease 92: /* Immediate Inputs. */ 
bit set(105 04); 
bit _set(1I04 04); 
break; 


case, 3. ° /* Imm. Sagneexor MSR sign */ 

bit _clear(I05_ 04); 
bit_clearGro azo) 

bit set ( l0smeae 

bit_set(I02_ 04); 

bitset (10120 
bit_clear(I00_04); 

next _level = FALSE; 

break; 


case °4’: /x Imm. sign exnor MSR sign */ 
bit_clear(I05 04); 
bit_clear(I04_ 04); 
bit.set @lOnm04 
Bbit-set( 102204 )- 
bit set(I0Ol 04); 
bit set(I00 04); 
next level = FALSE; 


Z09 


break; 


default: 


puts(" No help available yet. 
puts(” Start has process. trem 


next level = FALSE; 
sleep(2); 
break; 


return (next_level); 


} 


shift _set(pchar) 
char "tpehar. 


int backout; 


backout = 


OE 


switch (*pchar) 


case 


Cas c 


Gas ¢€ 


Case 


Cas € 


ga 0 age 

bit _clear(I09_ 04); 
bit _clear(I08_ 04); 
bit_clear(I107_04); 
bit. clearGivecu4 
break; 


Zeal ake! 
bit_clear(I09 04); 
bit clear (106.04 
bit_clear(I07_ 04); 
bit _set(I06 04); 
break; 


39 

bit _clear(I09_ 04); 
bit clear( 108104), 
bit_set(I07_04); 
bitoclear( 1l06n04)- 
break: 


“oe 

bit _clear(I09 _ 04); 
bit_clear(I08_ 04); 
bit _set(I07_04); 
bit _set(I06_ 04); 
break; 


a a 
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<n. 0 4 } : 


the beginning 
again. \nv0 oe 


case 


case 


Cas c 


case 


Casa € 


case 
case 


Caos 
case 


pitowcleartie9 (eg. 
bit _set(I08 04); 
bit _clear(I07 04): 
bit_clear(I06_04)}): 
break; 


oe 

bit _clear(I09_ 04); 
bit_set(I08_ 04); 
bit velear (107 2045. 
bit_set(1I06_04); 
break; 


pions 

bit _clear(I09 04); 
bit_set( 108 04); 
bit_set(1I07_04); 
bit_clear(I06_ 04); 
break; 


ape 

Div@vectear (109704 j): 
bit _ set(I08 04); 
bit _set(1I07_ 04); 
bit_set(106_ 04); 
break; 


Bo 
Bitveset 109 04). 
bit _clear(I08_04); 
Dit welear GL07 204 ); 
bit clear(106 04); 
break; 


Oe 

bit _set(109 04); 
bit _clear(I08_04); 
bat clear 7204)... 
bit set @rion04ay: 
break; 


ae 

aN 

bat set(LUucn04 : 
bit_clear(1I08 04); 
bit _set(I07 04); 
bit_clear(I06_ 04); 


break; 


"pb ¢ 
tae 


Zale: 


bit _set(109_ 04); 
bit clear 108 704s 
bit sett £07 707s 
bit _set( 106 04); 
break; 

case ’c’: 

case "C=: 
bitouset (l0g204 
bit set(108_ 04); 
bit -clearci07 104: 
bit _clear(I06_ 04); 
break; 


case °’d’: 

case ’D’: 
bit_set(I09 04); 
bit _set(I08 04); 
bit_clear(I07_ 04); 
bit _set(I06_04); 
break; 

case ’e’: 

case ’E’: 
bit_set(I09 04); 
bit_set(I08 04); 
bit see 1072040] 
bit_clear(I06_04) ; 
break; 


Case 7i 

case ’F’: 
bit _set(109 04); 
bit _set(108 04); 
bit set( 107 04); 
bit_set(I06_ 04); 
break; 

case ’n’: 

case ’N’: 
backout =1; 


break; 
default: 
puts( "Sorry, No Relp yet v=ey7ou re on youn 
own. \n\O ae 
sleep(2) ; 
break; 


return (backout); 


} 


Zaz 


earry set(pchar) 
Char *pchar: 
if 


NM 
switch (*pchar) 


ease 0: IIT eCarryinoow zero */ 
Datwolear  Pil2 04) 
biteclear( fll 04); 
break; 


case ’]’: yu Carry in ot one */ 
bt celear( fl2 04); 
bit _set(I11_04); 
break; 


@ase § 2°: f/* Carryin of Cx */ 
bit set i 112.04) ; 
bit clearCl ili 04. ; 
break; 


Casio 13s VARCAGE Yin. Of Micka carry */ 
/* Three possible choices here, how do we record and 
decide? */ 
bit oset rl 2 a0 
bit _set(I11_04); 
bit_clear(I05 04); 
bit _clear(103_04) ; 
break; 


case ’4’: (XxX Garmryinwvof Micro Carry not */ 

bie set (lizg.04). 

bit _set(I11_04); 

Ditrelear Ges 04): 

bit_set(I03_04); 

bit _clear(I02 04); 

but vebear ih 1 04). 

break; 


| case 75°: ~x* aceyineot MACRO carry */ 
/* Two other choices here, same problem as case 3 */ 
| bit_set(I12_04); 
| bit _set(I11_04); 
bit _set(I05_ 04); 
Ditwclear Cho c204 ) : 
break; 


ease) (oe ny ke ecaunyin sot MACRO carry not */ 
} bet set ( Giz oad): 


eye 





bit sete 04 js 
bit _ set 105 (04) 
bit seri fod. 0452 
bit clear(I02 04); 
bit clear(10 04). 
break; 


default: /* Help message on default */ 
puts("No help available yet!!\n\0"); 
sleep(2); 
break; 


Neat 
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Program Name: declare.h 

Purpose: This file is included with all other modules. 
When compiling the modules, this file must be 
in the same directory. 


/* declare.h is the latest header file for declarations for 
use with the 2900 system functional microprograming effort. 
This source is set up to work with the vtl00 from 
VAX/unix. */ 


/* This header file should be "#included” with all 
modules. */ 


/* LAST UPDATE: 5 sep 1984 */ 


#define erase screen "\033[2J\033[0;0H" /*x vtl00 erase 
screen and home cursor Kk / 


#define TRUE i 
#define FALSE 0 
#define false 0 
#define true il 
#define no_sub 0 


/* These defines relate to the 29203ET board, and should be 
contained ina routine to initialize them, rather than as 
defines. */ 


#define I12 04 16 
#define I11_04 Es 
#define T10_04 8 

#define I09 04 28 
#define 108 04 a 
#define 107 04 S10 
#define I06_04 Soul 
define 1O5.°0'4 18 
#define 104 _ 04 2 
#define I03 04 20 
#define I02 04 2) 
#define LO 04 Ze 
#define I00_ 04 23 
define Ceu_04 24 
#define CeM 04 oo 
#define Se_04 od 
#define Cmd_En 26 
#define Cmd_3 as 
#define Cmd_ 2 Zo 
#define Cmd_ 1 310 
#define Cmd_0 ay Al 
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/* these defines refer to the physical fields of the 


microword. They are used to pass field _ set the fields x; 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#tdefine 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
+#define 
#define 
#define 
#define 
#define 
#define 
+#define 
#define 


reg sre l 
ien_fld 2 

oey_ fld 3 
srce_fld 4 
dest_fld 5 
funes 1 kdb 
Carrying iid) 
I5I4_ fld 8 

Soe Ot lee 
152 TO St duo 
ceus £ lide el 
cem: tf idasi2 
cmden_fld 13 
shiften_fld 14 
command fld 15 
shirt of ld elo 
breakpoint fld 
notused_fld 18 
msb br. f lass 
mid birt kde 
lisbo br ot la eZ 
rega fld 22 
regbp 1 ld 23 
seq _fld 24 


condtest_fld 25 


i 


Program Name: extern.h 

Purpose: This file is included in all modules which are not 
"main" programs. It must reside in the same directory 
in which all compilations are made. 


/* This header file used to assign external definitions to 
all files except the main program. The original definitions 
should be contained in the main program. */ 


/* LAST UPDATE: 5 Sep 1984 */ 


extern int docu_word[ 24]; 
extern char cmd_line[80],*pcemd,micro_word[{49],*pmwd; 


ho 
bh 
~) 


The following is the Compatibility Test program. 


APPENDS C 


It demonstrates the 


algorithm for finding compatible bit patterns when conflicts occur in 
shared microword fields. 


#include <stdio.h> 


/* We need a static data structure which holds the different 


choices available for bits I15 to I0 of the 2904. ho 

char *choices 04(n) /* return a pointer to the nth choice. */ 
wae. hae 
{ 
static char *ehoice |e 
"OXOXXKK",/* carry in = Ww carry, firstechoice, (aes 
"OXXIXX",/* carry in = wu carry, second choice, — ls 
"OXXX1X",/* carry in = Ww carry, third ehioivce 2a 
"LXOXXXK",/* carry in=Macro carry,tfirst ‘cie1¢e. ow 
"LXXIXX",/* carry in=Macro carry, second choice =. ina 
"LXXX1X",/* carry in=Macro carry, third choice — cae 
"Q0011X",/* Load u register,retain overflow bit —~cme 
"X1L100X",/* Load u reg,invert carry,first cholce = aa 
"1X100X",/* Load u reg,invert carry,second choice )—] cam 
"XXO10K",/* Load u reg, immed., first choice. —J94) 
"K10XXX",/* Load u reg, immed., second choice. ~-10 */ 
"XIXX1X",/* Load u reg, immed., third choice. —liaew 
"XIX1XK",/* Load u reg, immed., fourth choice. -l2 *’ 
"UXOXXX",/* Load u reg, immed., fitth cheice. — lime 
"LXXX1X",/* Load u reg, immed., sixth choice. —-itye 
"UXX1LXX",/* Load u reg, immed., seventh choice. -15 */ 
"XX100X",/* Load M reg, invert carry -16 */ 
"XXX1LIX",/* Load M reg, immed; first@enoitce — ie 
"XX1X1X",/* Load M reg, immed, second choice -18 */ 
"XX1LIXK",/* Load M reg, immed, third choice -19 */ 
"XlLOXKK",/* Load M reg, immed, fourth choice -2Z0 ee 
"LXOXXK"/* Load M reg, immed, fifth choice -21 */ 
ne 

return (choice Ji niger 

} 

main( ) 


f 
t 


int, iseon tr Wire: 


char *result; 


maaeic char *ptrarray / ]; 
Bedntt("Pick your first choice for bits 15-10, 0-21\n"}: 
meani( "%d",&n); 
esult = choices 04(n)/; 
ptrarray{0O]=choices 04(n); 
mmmmet( ~d\n",result); 
pmemnti(' tThe nth choice picked is, %4d, the bits are, 
aS sulle swert ): 
Mmmm Fick your second choice for bits I5-10, O-21\n”"); 
eeeami("%d"',&n); 
result = choices 04(n); 
proarray({l]l|=choices 04(n); 
Peerntt(’ The nth choice picked is,«xd, the bits are, 
PaSe lio Ma eS ual ta 


Pec t{ Ptrarray|OjJ= *c\n",*ptrarray([0]); 
mmmntti(¢ Ptrarray|l|= %c\n",*ptrarray([1l1]); 
Premmti( ‘the value which starts at ptrarray(0j}] is 
[om pcr artay )ou:. 
premmci( ‘the value which starts at ptrarray[1] is 
Mean .ptrarray | li oe 


@ontlict=0; 


fom) (1=0;1<6;i++) 


! } 
1 t 


mein *(ptrarray([O}] + i) 
(*(ptrarray[0] + i 
{ 
SoOnmunet =O * 
Peenet  conflict=0\n" ); 
} 
else { 
Cont! ret=)]> 
peinece contlict=l\n" ); 
break; 
} 
ompemet( contlict = *®¥d\n",conflict); 
Meantt("’The index, i= %d\n",1); 


# ( piparray ide L).) 
=e we enibin mien ayy | +i — x > 


— 
— 
~— 


) 


me conflict == 1) 
Beinmeme Had a conflict!\n’" ); 
else 


Pierictice No conflicts! \n" )- 


JK KKK KK KK KK KKK KKK KK KKK KK KK KKK KKK KKK KKK KKK KKK KK KK / 


metrarray|0|=’ 0’ 
Menrarray,i|=' 1’; 
meerptrarray|0)==*ptrarray (1) 


eg 


printf("Thev were equal”); 
else 
printf("They were not equal”); 


Zee 
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